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Introduction 



En debut d'annee, un editeur de Pearson m'a demande 
d'ecrire ce Guide de survie consacre au Java, opus d'une 
collection regroupant un certain nombre d'autres ouvra- 
ges, dont Christian Wenz avait ecrit le premier consacre 
au PHP (premiere partie du Guide de survie PHP et 
MySQL). L'idee de la collection Guide de survie est tiree 
des guides de conversation pour le tourisme dans les pays 
etrangers qui proposent des listes de phrases pour s'expri- 
mer dans une autre langue. Ces manuels sont tres utiles 
pour ceux qui ne connaissent pas la langue locale. Le prin- 
cipe des ouvrages de la collection Guide de survie est ana- 
logue, lis montrent au lecteur comment realiser des taches 
courantes dans le cadre d'une technologie particuliere. 

Le but de ce Guide de survie est de fournir une liste 
d'exemples de code couramment utilises en programma- 
tion Java. Ce livre doit etre utile a la fois au programmeur 
Java confirme et a celui qui debute avec ce langage. S'il 
peut etre lu de bout en bout afin d'acquerir une vue 
d'ensemble du langage Java, il est avant tout concu 
comme un ouvrage de reference qui peut etre consulte a 
la demande lorsque le programmeur doit savoir comment 
realiser une tache courante en Java. Vous pouvez aussi 
explorer ce livre afin de decouvrir des fonctionnalites et 
des techniques Java que vous n'avez pas encore maitrisees. 
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Ce livre n'est pas un manuel d'apprentissage ou d'intro- 
duction au Java ni une reference complete de ce langage. 
II existe bien d'autres classes et API que celles presentees 
ici. D'excellents livres ont deja ete publies qui vous per- 
mettront d'apprendre le Java ou serviront de reference en 
abordant toutes les fonctionnalites possibles et imagina- 
bles. Si votre but est d'acquerir une comprehension tres 
vaste d'une technologie specifique, il est preferable de 
consulter un livre adapte. 

La plupart des exemples presentes dans ce livre n'incluent 
pas de code de gestion des erreurs. Bon nombre de ces 
fragments de code sont cependant susceptibles de lever 
des exceptions qu'il vous faudra imperativenient gerer 
dans vos propres applications. Le code de gestion des 
erreurs et des exceptions est volontairement omis ici, afin 
que le lecteur puisse se concentrer specifiquement sur la 
notion illustree par l'exemple, sans etre distrait par d'autres 
considerations. Si les exemples avaient inclus 1' ensemble 
du code de gestion des exceptions, ils n'auraient pour la 
plupart pas pu prendre la forme compacte et synthetique 
qui est la leur et vous n'auriez pas mieux compris les 
notions abordees. La JavaDoc du JDK Java est une excel- 
lente source d'informations pour retrouver les exceptions 
qui peuvent etre levees par les niethodes contenues dans 
les classes Java rencontrees dans ce livre. Pour la consulter, 
rendez-vous a l'adresse http://java.sun.eom/j2se/l.5.0/ 
docs/api/. 

Les exemples de ce livre doivent etre independants du 
systeme d'exploitation. Le mot d'ordre de la plate-forme 
Java ("programme une fois, execute partout") doit 
s'appliquer a tous les exemples contenus dans ce livre. 
Le code a ete teste sous le JDK 1.5 aussi appele Java 5.0. 



La plupart des exemples fonctionnent aussi sous les ver- 
sions precedentes du JDK, sauf mention speciale a ce sujet. 

Tous les exemples ont ete testes et doivent etre exempts 
d'erreurs. Je souhaite pour ma part que le livre ne 
contienne pas la moindre erreur, mais il faut evidem- 
ment admettre qu'aucun livre technique ne peut par 
definition y pretendre. Toutes les erreurs qui pourraient 
etre trouvees dans l'ouvrage seront signalees sur le site 
www.samspublishing.com. 

En redigeant ce livre, j'ai tente de trouver les exemples les 
plus utiles tout en m'astreignant a l'exigence de concision 
de la collection Guide de survie. II est immanquable qu'a 
un moment ou un autre, vous rechercherez un exemple 
qui ne figurera pas dans ce livre. Si vous estimez qu'un 
exemple important manque, signalez-le moi. Si vous pen- 
sez a l'inverse que d'autres exemples du livre ne sont pas 
si utiles, indiquez-le moi egalement. En tant qu'auteur, 
j'apprecie toujours de connaitre le sentiment des lecteurs. 
A l'avenir, il est possible qu'une seconde edition du livre 
voit le jour. Vous pouvez me contacter en consultant 
mon site Web a l'adresse www.timothyfisher.com. 
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Les bases 



Ce chapitre presente les premiers exemples avec lesquels 
vous aurez besoin de vous familiariser pour demarrer un 
developpement Java. lis sont en fait requis pour realiser 
quelque action que ce soit en Java. Vous devez pouvoir 
compiler et executer votre code Java et comprendre les 
chemins de classe Java. A la difference d'autres langages 
comme le PHP ou le Basic, le code source Java doit etre 
compile sous une forme appelee "code-octet" (bytecode) 
avant de pouvoir etre execute. Le compilateur place le 
code-octet dans des fichiers de classe Java. Tout program- 
meur Java doit done comprendre comment compiler son 
code source en fichiers de classe et savoir executer ces 
fichiers de classe. La comprehension des chemins de classe 
Java est importante a la fois pour compiler et pour exe- 
cuter le code Java. Nous commencerons done par ces 
premiers exemples. 

II est aujourd'hui courant de travailler au developpement 
Java dans un EDI (environnement de developpement inte- 
gre) comme le projet libre Eclipse (http://www.eclipse 
.org). Pour ce chapitre, nous considererons que vous rea- 
liserez vos taches en ligne de commande. 
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Si l'essentiel de votre developpenient peut parfaitement se 
faire avec un EDI, tout developpeur se doit cependant 
d'etre familiarise avec la configuration et la realisation de 
ces taches en dehors d'un EDI. La procedure propre aux 
taches effectuees dans un EDI varie selon l'EDI : il est done 
preferable dans ce cas de consulter le manuel de l'EDI 
concerne pour obtenir de l'aide a ce sujet. 

Pour executer les instructions contenues dans ce chapitre, 
vous devez obtenir une distribution Java aupres de Sun. 
Sun diffuse la technologie Java sous plusieurs formes. Les 
distributions Java les plus courantes sont le Java Standard 
Edition (SE), le Java Enterprise Edition (EE) et le Java 
Micro Edition (ME). Pour suivre tous les exemples de ce 
livre, vous n'aurez besoin que du paquetage Java SE. Java 
EE contient des fonctionnalites supplementaires permettant 
de developper des applications d'entreprise. Java ME est 
destine au developpenient d'applications pour les peri- 
pheriques tels que les telephones cellulaires et les assistants 
personnels. Tous ces paquetages peuvent etre telecharges 
depuis le site Web de Sun a l'adresse http:/ /java.sun.com. 
A l'heure ou ces lignes sont ecrites, J2SE 5.0 est la version 
la plus recente du Java SE. A moins que vous n'ayez une 
raison particuliere d'utiliser une version anterieure, utili- 
sez done cette version avec ce livre. Vous trouverez deux 
paquetages a telecharger dans le J2SE 5.0 : le JDK et le 
JPvE. Le JDK est le kit de developpenient Java. II est 
necessaire pour developper des applications Java. Le JPvE 
(Java runtime edition) ne permet que d'executer des appli- 
cations Java et non d'en developper. Pour ce livre, vous 
aurez done besoin de la distribution JDK du paquetage 
J2SE 5.0. 
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Info 

J2SE 5.0 et JDK 5.0 sont souvent aussi mentionnes sous la 
reference JDK 1.5. Sun a decide de changer officiellement le 
nom de la version 1.5 en I'appelant 5.0. 



Pour obtenir de l'aide lors de l'installation de la version 
la plus recente du Java J2SE JDK, voir http://java.sun 
.com/j2se/1.5.0/install.html. 

Compiler un programme Java 



javac HelloWorld. java 



Cet exemple compile le fichier source HelloWorld . j ava 
en code-octet. Le code-octet est la representation Java 
independante de toute plate-forme des instructions d'un 
programme. La sortie sera placee dans le fichier Hello- 
World . class. 

L'executable javac est inclus dans la distribution Java JDK. 
II est uti'lise pour compiler les fichiers source Java que 
vous ecrivez dans des fichiers de classe Java. Un fichier de 
classe Java est une representation en code-octet de la source 
Java compilee. Pour plus d'informations sur la commande 
javac, consultez la documentation du JDK. De nombreu- 
ses options peuvent etre utilisees avec javac qui ne sont 
pas traitees dans ce livre. 

Pour la plupart de vos projets de programmation, a 
l'exception des petits programmes tres simples, vous utili- 
serez sans doute un EDI ou un outil comme Ant d' Apache 
pour realiser votre compilation. Si vous compilez autre 
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chose qu'un tres petit projet avec des fichiers source mini- 
maux, il est vivement conseille de vous familiariser avec 
Ant. Si vous connaissez l'outil de compilation Make utilise 
par les progranimeurs C, vous comprendrez l'importance 
d'Ant. Ant est en quelque sorte l'equivalent de Make 
pour Java. II permet de creer un script de compilation 
pour specifier les details de la compilation d'une applica- 
tion complexe puis de generer automatiquement l'appli- 
cation complete a l'aide d'une seule commande. Pour plus 
d'informations sur Ant et pour telecharger le programme, 
rendez-vous a l'adresse http://ant.apache.org. 

Executer un programme Java 



javac HelloWorld. java // compilation du fichier source 
java HelloWorld // execution du code-octet 



Dans cet exemple, nous utilisons d'abord le compilateur 
javac pour compiler notre source Java dans un fichier 
HelloWorld . class. Ensuite, nous executons le programme 
HelloWorld en utilisant la commande java a laquelle 
nous passons le nom de la classe compilee, HelloWorld. 
Notez que l'extension .class n'est pas incluse dans le 
nom qui est passe a la commande java. 

L'executable java est inclus avec la distribution Java JDK 
ou la distribution Java JRE. II est utilise pour executer les 
fichiers de classe Java compiles. II fait office d'interpreteur 
et compile en temps reel le code-octet en code natif exe- 
cutable sur la plate-forme utilisee. L'executable java est 
un element de Java dependant de la plate-forme d'execu- 
tion. Chaque plate-forme qui supporte Java possede ainsi 
son propre executable java compile specifiquement pour 
elle. Cet element est aussi appele la machine virtuelle. 
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Definir le chemin de classe 



set CLASSPATH = lutilisateurlprojetslclasses 
java -classpath = 

»»CLASSPATH%; classes / classf ile .class ; libs / stuff . j ar 



Le chemin de classe est utilise par l'executable j ava et le 
compilateur j ava pour trouver les fichiers de classe com- 
piles et toutes les bibliotheques empaquetees sous forme 
de fichiers JAR requis pour executer ou compiler un pro- 
gramme. Les fichiers JAR sont le moyen standard 
d'empaqueter des bibliotheques dans une ressource pre- 
nant la forme d'un fichier unique. L'exemple precedent 
montre comment le chemin de classe peut etre defini lors 
de 1' execution d'un programme Java en ligne de com- 
mande. Par defaut, le chemin de classe est obtenu depuis 
la variable d'environnement systeme CLASSPATH. Dans cet 
exemple, une classe specifique appelee classf ile . class et 
situee dans le dossier classes est ajoutee au chemin de 
classe defini par la variable d'environnement. Une biblio- 
theque appelee stuff .jar situee dans le repertoire libs 
est egalement ajoutee au chemin de classe. Si la variable 
d'environnement CLASSPATH n'est pas definie et que 
l'option —classpath n'est pas utilisee, le chemin de classe 
par defaut correspond au repertoire courant. Si le chemin 
de classe est defini avec l'une de ces options, le repertoire 
courant n'est pas automatiquement inclus dans le chemin 
de classe. II s'agit la d'une source frequente de problemes. 
Si vous definissez un chemin de classe, vous devez expli- 
citement rajouter le repertoire courant. Vous pouvez tou- 
tefois ajouter le repertoire courant au chemin de classe en 
le specifiant par "." dans le chemin de classe. 
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Attention 

Notez que si toutes les classes se trouvent dans un repertoire 
inclus dans le chemin de classe, il faut neanmoins que les 
fichiers JAR soient explicitement inclus dans le chemin de 
classe pour etre trouves. II ne suffit pas d'inclure le repertoire 
dans lequel ils resident a I'interieur du chemin de classe. 



Les problemes lies aux chemins de classe sont tres courants 
chez les programmeurs novices comme chez les program- 
meurs experimentes et peuvent souvent etre tres agacants 
a resoudre. Si vous prenez le temps de bien comprendre 
le fonctionnement des chemins de classe et de bien savoir 
les definir, vous devriez pouvoir eviter ces problemes dans 
vos applications. Pour plus d'informations sur la confi- 
guration et l'utilisation des chemins de classe, consultez 
la page http://java.sun.eom/j2se/l.5.0/docs/tooldocs/ 
windows/ classpath.html. 
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Interagir avec 
renvironnement 



Ce chapitre regroupe 1' ensemble des exemples qui vous 
permettront d'interagir avec l'environnement d'execution 
sur lequel votre application s'execute. Plusieurs d'entre 
eux utilisent l'objet Java System, un objet Java central 
destine a interagir avec l'environnement qui entoure 
votre application Java. II faut etre tres prudent lorsque 
vous utilisez cet objet et plus generalement lorsque vous 
interagissez avec l'environnement, car vous risquez par 
inadvertance de creer du code dependant de votre plate- 
forme. L'objet System interagit avec l'environnement et 
ce dernier est bien sur propre a la plate-forme sur laquelle 
vous travaillez. Les effets de l'utilisation d'une methode 
ou d'une propriete de System sur une plate-forme peu- 
vent ainsi ne pas etre les memes sur 1' ensemble des autres 
plates-formes. 
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Obtenir des variables 
d'environnement 



String envPath = System . getenv ( " PATH " ) ; 



Cet exemple montre comment recuperer une variable 
d'environnement avec la methode System . getenv () . 
Cette methode a ete deconseillee dans les versions du JDK 
comprises entre la version 1.2 et la version 1.4. Avec le 
JDK 1.5, Sun a pris une mesure exceptionnelle en reve- 
nant sur sa decision et en rehabilitant cette methode. Si 
vous utilisez une version du JDK pour laquelle cette 
methode est deconseillee, vous verrez des avertissements 
apparaitre au moment de la compilation lorsque vous ten- 
tez d'utiliser cette methode. Les methodes deconseillees 
ne doivent pas etre utilisees dans les nouveaux projets de 
developpement mais restent generalement prises en 
charge pour des raisons de compatibilite arriere. II n'existe 
pas de garantie que les methodes deconseillees continuent 
d'etre prises en charge dans les versions futures du JDK, 
mais dans le cas precis de cette methode, il se trouve que 
la version la plus recente du JDK l'a rehabilitee : vous 
pouvez done raisonnablement supposer qu'elle conti- 
nuera d'etre prise en charge. 

En general, on considere qu'il est de mauvais usage d'uti- 
liser des variables d'environnement dans les applications 
Java. Celles-ci dependent en effet de la plate-forme, or 
lejava a justement pour vocation d'etre independant de 
toute plate-forme. Certaines plates-formes Java (notam- 
ment Macintosh) ne proposent d'ailleurs pas de variable 
d'environnement. Votre code ne se comportera done 
pas comme prevu dans ces environnements. 
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L'exemple suivant montre comment obtenir et definir 
des proprietes systeme. Cette approche est preferable a 
celle qui consiste a utiliser des variables d'environnement. 

Definir et obtenir 
des proprietes systeme 



System . setProperty ( " timezone" , " EasternStandardTime" ) ; 
String zone = System. getProperty(" timezone" ) ; 



Les proprietes systeme sont des paires cle/valeur externes a 
votre application Java. L'objet Java System propose un 
mecanisme permettant de lire les noms et les valeurs de 
ces proprietes systeme externes depuis votre application 
Java. L'exemple precedent montre comment definir et lire 
une propriete systeme a l'aide de l'objet Java System. Vous 
pouvez aussi recuperer toutes les proprietes systeme dans 
un objet de proprietes a l'aide de l'instruction suivante : 

Properties systemProps = System. getProperties( ) ; 

Une autre methode permet egalement de recuperer les 
noms des proprietes systeme. Le fragment de code suivant 
indique comment recuperer tous les noms des proprietes 
systeme puis recuperer chaque propriete avec son nom : 
Properties props = System. getProperties() ; 
Enumeration propertyNames = props . propertyNames( ) ; 
String key = " " ; 

while (propertyNames . hasMoreElements () ) { 

key = (String) propertyNames. nextElement() ; 
System. out . println (key + "=" + 

props. getProperty(key) ) ; 

} 
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Parser des arguments en ligne 
de commande 



java my_program arg1 arg2 arg3 

public static void main(String[] args) { 
String arg1 = args[0] ; 
String arg2 = args[1]; 
String arg3 = args [2]; 

} 



Dans cet exemple, nous stockons les valeurs de trois argu- 
ments en ligne de commande dans trois variables String 
separees, arg1, arg2 et arg3. 

Toutes les classes Java peuvent inclure une methode main ( ) 
executable en ligne de commande. La methode main ( ) 
accepte un tableau String d'arguments en ligne de com- 
mande. Les arguments sont contenus dans le tableau dans 
l'ordre ou ils sont entres dans la ligne de commande. Pour 
les recuperer, il vous suffit done d'extraire les elements du 
tableau des arguments passe a la methode main ( ) . 

Si votre application utilise un grand nombre d'arguments 
en ligne de commande, il peut etre utile de passer du temps 
a concevoir un parseur d'arguments en ligne de com- 
mande persomialise pour comprendre et gerer les differents 
types d'arguments en ligne de commande, comme les para- 
metres a un caractere, les parametres avec des tirets (-), 
les parametres immediatement suivis par un autre parame- 
tre lie, etc. 
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Info 



De nombreux exemples de processeurs d'arguments en ligne de 
commande peuvent etre trouves sur Internet afin de gagner du 
temps. Deux bonnes bibliotheques peuvent etre utilisees pour 
demarrer : 

http://jargs.sourceforge.net 
https://args4j.dev.java.net/ 

Ces deux bibliotheques peuvent analyser les arguments d'une 
ligne de commande complexe a I'aide d'une interface relative- 
ment simple. 



3 



Manipuler 
des chaines 



En programmation, quel que soit le langage utilise, une 
grande partie des operations realisees concerne la manipu- 
lation des chaines. A l'exception des donnees nunieri- 
ques, presque toutes les donnees sont gerees sous forme 
de chaines. Les donnees numeriques sont d'ailleurs parfois 
elles-memes manipulees sous cette forme. On s'imagine 
difficilement comment il serait possible d'ecrire un pro- 
gramme complet sans utiliser la moindre chaine. 

Les exemples de ce chapitre presentent des taches couran- 
tes liees a la manipulation des chaines. Le langage Java 
propose une excellente prise en charge des chaines. A la 
difference du langage C, les chaines sont des types prede- 
finis dans le langage Java. Celui-ci contient une classe 
String specifiquement destinee a contenir les donnees de 
chaine. En Java, les chaines ne doivent pas etre conside- 
rees a la maniere de tableaux de caracteres comme elles le 
sont en C. 
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Chaque fois que vous souhaitez representer une chaine en 
Java, vous devez utiliser la classe String et non un tableau. 

La classe String possede une propriete importante : une 
fois creee, la chaine est immuable. Les objets Java String 
ne peuvent done plus etre changes apres qu'ils sont crees. 
Vous pouvez attribuer le noni donne a une chaine a un 
autre objet String, mais vous ne pouvez pas changer le 
contenu de la chaine. Vous ne trouverez done aucune 
methode set dans la classe String. Si vous souhaitez creer 
une chaine a laquelle des donnees peuvent etre ajoutees 
(par exemple, dans une routine qui construit progressive- 
ment une chaine), vous devez utiliser la classe String- 
Builder dans le JDK 1.5 ou la classe StringBuff er dans les 
versions anterieures du Java, et non la classe String. Les 
classes StringBuilder et StringBuffer sont muables : leur 
contenu peut etre modifie. II est tres courant de construire 
des chaines en utilisant la classe StringBuilder ou String- 
Buffer et de passer ou stocker des chaines en utilisant la 
classe String. 



Comparer des chaines 



r 

boolean 


result = 


"1 

stn .equals(str2) ; 


boolean 


result2 


= stn .equals!gnoreCase(str2) ; 



La valeur de result et result2 doit etre true si les chaines 
ont le menie contenu. Si leur contenu est different, 
result et result2 valent false. La premiere methode, 
equals(), tient compte de la casse des caracteres dans les 
chaines. La seconde, equalsIgnoreCase ( ) , ignore la casse 
des caracteres et retourne true si le contenu est identique 
independamment de la casse. 
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Les operations de comparaison de chaines sont une source 
courante de bogues pour les programmeurs debutants en 
Java. Ces derniers s'efforcent souvent de comparer leurs 
chaines avec l'operateur de comparaison ==. Or ce dernier 
compare les references d'objet et non le contenu des 
objets. Deux objets chaine qui contiennent les memes 
donnees de chaine mais correspondent a des instances 
d'objet physiquement distinctes ne sont des lors pas consi- 
deres comme egaux selon cet operateur. 

La methode equals() de la classe String fait porter la 
comparaison sur le contenu de la chaine et non sur sa refe- 
rence d'objet. En general, il s'agit de la methode de com- 
paraison souhaitee pour les comparaisons de chaines. 
Voyez l'exemple suivant : 

String namel = new String ( "Timmy" ) ; 
String name2 = new String ( "Timmy" ) ; 
if (namel == name2) { 

System. out. println ( "The strings are equal."); 

} 

else { 

System. out. println ( "The strings are not equal."); 

} 

La sortie obtenue apres l'execution de ces instructions est 
la suivante : 

The strings are not equal. 

A present, utilisez la methode equals () et observez le 
resultat : 

String namel = new String ( "Timmy" ) ; 
String name2 = new String ( "Timmy" ) ; 
if (namel .equals(name2) ) { 

System. out. println("The strings are equal."); 
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} 

else { 

System. out . println( "The strings are not equal."); 

} 

La sortie obtenue apres l'execution de ces instructions est 
la suivante : 

The strings are equal. 

La methode compareTo( ) est une autre methode apparen- 
tee de la classe String. Elle compare alphabetiquement 
deux chaines en retournant une valeur entiere : positive, 
negative ou egale a 0. La valeur 0 n'est retournee que si 
la methode equals () est evaluee a true pour les deux 
chaines. Une valeur negative est retournee si la chaine sur 
laquelle la methode est appelee precede dans l'ordre 
alphabetique celle qui est passee en parametre a la 
methode. Une valeur positive est retournee si la chaine 
sur laquelle la methode est appelee suit dans l'ordre alpha- 
betique celle qui est passee en parametre. En fait, la 
comparaison s'effectue en fonction de la valeur Unicode 
de chaque caractere dans les chaines comparees. La 
methode compareTo() possede egalenient une methode 
compareToIgnoreCase( ) correspondante qui opere de la 
meme maniere mais en ignorant la casse des caracteres. 
Considerez l'exemple suivant : 

String namel =" Camden " ; 

String name2="Kerry" ; 

int result = namel .compareTo(name2) ; 

if (result == 0) { 

System .out . println( "The names are equal."); 

} 
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else if (result > 0) { 
System. out. println( 

"name2 comes before namel alphabetically."); 
} 

else if (result < 0) { 
System. out. println( 

"namel comes before name2 alphabetically."); 

} 

La sortie de ce code est : 

namel comes before name2 alphabetically. 

Rechercher et recuperer 
des sous-chames 



int result = stringl . indexOf (string2) ; 
int result = stringl .indexOf (string2, 5); 



Dans la premiere methode, la valeur de result contient 
l'index de la premiere occurrence de string2 a l'interieur 
de stringl. Si string2 n'est pas contenu dans stringl, la 
valeur -1 est retournee. 

Dans la seconde methode, la valeur de result contient 
l'index de la premiere occurrence de string2 a l'interieur 
de stringl qui intervient apres le cinquieme caractere 
dans stringl. Le second parametre peut etre n'importe 
quel entier valide superieur a 0. Si la valeur est superieure 
a la longueur de stringl , la valeur -1 est retournee. 

Outre rechercher une sous-chaine dans une chaine, il 
peut arriver que vous sachiez ou se trouve la sous-chaine 
et que vous souhaitiez simplement l'atteindre. La methode 
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substring () dela chaine vous permet de l'atteindre. Cette 
methode est surchargee, ce qui signifie qu'il existe plu- 
sieurs moyens de l'appeler. Le premier consiste a lui passer 
simplement un index de depart. Cette methode retourne 
une sous-chaine qui commence a l'index de depart et 
s'etend jusqu'a la fin de la chaine. L'autre moyen d'utiliser 
substring () consiste a l'appeler avec deux parametres - 
un index de depart et un index de fin. 

String stringl = "My address is 555 Big Tree Lane"; 
String address = stringl .substring(14) ; 
System. out. println (address) ; 

Ce code produit la sortie suivante : 
555 Big Tree Lane 

Le premier caractere 5 se trouve a la position 14 de la 
chaine. II s'agit done du debut de la sous-chaine. Notez 
que les chames sont toujours indexees en commencant a 0 
et que le dernier caractere se trouve a l'emplacement 
(longueur de la chaine) - 1. 

Traiter une chaTne caractere 
par caractere 



for (int index = 0; index < stringl . length( ) ; 
index++) { 

char aChar = stringl .charAt( index) ; 

} 



La methode charAt () permet d'obtenir un unique caractere 
de la chaine a l'index specifie. Les caracteres sont indexes 
en commencant a 0, de 0 a (longueur de la chaine) - 1. 



Renverser une chatne par caractere 

Cet exemple parcourt en boucle chaque caractere contenu 
dans stringl. II est aussi possible de proceder en utilisant 
la classe StringReader, comme ceci : 

StringReader reader = new StringReader(string1 ) ; 
int singleChar = reader . read( ) ; 

Avec ce mecanisme, la methode read( ) de la classe Strin- 
gReader retourne un caractere a la fois, sous forme 
d'entier. A chaque fois que la methode read ( ) est appelee, 
le caractere suivant de la chaine est retourne. 

Renverser une chaine 
par caractere 



String letters = " ABCDEF" ; 

StringBuffer lettersBuff = new StringBuffer(letters) ; 
String lettersRev = lettersBuff .reverse() .toString() ; 



La classe StringBuffer contient une methode reverse () 
qui retourne un StringBuffer contenant les caracteres du 
StringBuffer original, mais inverses. Un objet StringBuf- 
fer petit aisement etre converti en objet String a l'aide de 
la methode toString() de l'objet StringBuffer. En utili- 
sant temporairement un objet StringBuffer, vous pouvez 
ainsi produire une seconde chaine avec les caracteres 
d'une chaine d'origine, en ordre inverse. 

Si vous utilisez le JDK 1.5, vous pouvez utiliser la classe 
StringBuilder au lieu de la classe StringBuffer. String- 
Builder possede une API compatible avec la classe 
StringBuffer. Elle propose de meilleures performances, 
mais ses methodes ne sont pas synchronisees. Elle n'est 
done pas thread-safe. En cas de multithreading, vous devez 
continuer a utiliser la classe StringBuffer. 
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Renverser une chame par mot 



String test = "Reverse this string"; 
Stack stack = new Stack(); 

StringTokenizer strTok = new StringTokenizer(test) ; 

while(strTok.hasMoreTokens()) { 

stack . push ( strTok . next Element ( ) ) ; 

} 

StringBuffer revStr = new StringBuffer() ; 
while(!stack.empty()) { 

revStr . append ( stack . pop ( ) ) ; 

revStr. append (" "); 

} 

System. out. println( "Original string: " + test); 
System. out. println("\nReversed string: " + revStr); 



La sortie de ce fragment de code est la suivante : 
Original string: Reverse this string 
Reversed string: string this Reverse 

Comme vous pouvez le voir, le renversement d'une 
chaine par mot est plus complexe que le renversement 
d'une chaine par caractere. C'est qu'il existe un support 
integre dans Java pour le renversement par caractere, et 
non pour le renversement par mot. Pour realiser cette 
derniere tache, nous utilisons les classes StringTokenizer 
et Stack. Avec StringTokenizer, nous parsons chaque 
mot de la chaine et le poussons dans notre pile. Une fois 
la chaine entiere traitee, nous parcourons la pile en boucle 
en depilant chaque mot et en l'ajoutant a un StringBuffer 
qui stocke la chaine inversee. 



Convertir une chaine en majuscules ou en minuscules 

Dans la pile, le dernier element entre est par principe le 
premier sorti — une propriete baptisee LIFO (last in, first 
out) que nous exploitons pour effectuer Pinversion. 

Consultez l'exemple traite dans la section "Parser une 
chaine separee par des virgules" de ce chapitre pour 
d'autres utilisations de la classe StringTokenizer. 

Info 

Nous n'en traiterons pas ici, mais un nouvel ajout du JDK 1.5 
peut vous interesser : la classe Scanner. Cette classe est un 
analyseur de texte elementaire permettant de parser des types 
primitifs et des chaTnes a I'aide d'expressions regulieres. 



Convertir une chaine en 
majuscules ou en minuscules 



String string = "Contains some Upper and some Lower."; 
String string2 = string. toUpperCase( ) ; 
String string3 = string. toLowerCase( ) ; 



Ces deux methodes transforment une chaine en majuscu- 
les ou en minuscules uniquement. Elles retournent toutes 
deux le resultat transforme. Ces methodes n'affectent pas 
la chaine d'origine. Celle-ci reste intacte avec une casse 
mixte. 

Ces methodes peuvent notamment etre utiles lors du 
stockage d'informations dans une base de donnees, par 
exemple si vous souhaitez stocker des valeurs de champ en 
majuscules ou en minuscules uniquement. Grace a ces 
methodes, l'operation de conversion est un jeu d'enfant. 
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La conversion de la casse est egalenient utile pour la ges- 
tion des interfaces d'authentification des utilisateurs. Le 
champ d'lD de l'utilisateur est normalement considere 
comnie etant un champ qui ne doit pas tenir compte de la 
casse, alors que le champ de mot de passe en tient compte. 
Lors de la comparaison de l'ID utilisateur, vous pouvez 
ainsi convertir l'ID en majuscules ou en minuscules puis 
le comparer a une valeur stockee dans la casse appropriee. 
Vous pouvez aussi utiliserla methode equalsIgnoreCase( ) 
de la classe String, qui realise une comparaison sans tenir 
compte de la casse. 

Supprimer les espaces au debut 
et a la fin d'une chaTne 



String result = str.trim() ; 



La methode trim( ) supprime les espaces de debut et de fin 
d'une chaine et retourne le resultat. La chaine originale 
reste inchangee. S'il n'y a pas d'espace de debut ou de fin 
a supprimer, la chaine d'origine est retournee. Les espaces 
et les caracteres de tabulation sont supprimes. 

Cette methode est tres utile lorsqu'il s'agit de comparer 
des entrees saisies par l'utilisateur avec des donnees exis- 
tantes. Bien des programmeurs se sont creuse la tete de 
nombreuses heures en se demandant pourquoi les don- 
nees saisies n'etaient pas identiques a la chaine stockee et 
se sont finalement apercu que la difference ne tenait qu'a 
un simple espace blanc a la fin de la chaine. La suppression 
des espaces avant les comparaisons elimine entierement ce 
probleme. 
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Parser une chame separee 
par des virgules 



String str = "tim,kerry,timmy,camden" ; 
String[] results = str. split ( " , " ) ; 



La methode split ( ) de la classe String accepte une expres- 
sion reguliere comme unique parametre et retourne un 
tableau d'objets String decompose selon les regies de 
l'expression reguliere passee. Le parsing des chaines sepa- 
rees par des virgules devient ainsi un jeu d'enfant. Dans 
cet exemple, nous passons simplement une virgule a la 
methode split () et obtenons un tableau de chaines con- 
tenant les donnees separees par des virgules. Le tableau de 
resultat de notre exemple contient ainsi les donnees 
suivantes : 

results[B] = tim 
results[1] = kerry 
results[2] = timmy 
results[3] = camden 

La classe StringTokenizer est elle aussi utile pour 
decomposer des chaines. L'exemple precedent peut etre 
repris avec cette classe au lieu de la methode split ( ) : 

String str = "tim, kerry, timmy, Camden" ; 
StringTokenizer st = new StringTokenizer(str, ","); 
while (st . hasMoreTokens ( ) ) { 

System. out .println(st . nextToken( ) ) ; 

} 
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Cet exemple de code imprime chacun des noms contenus 

dans la chaine d'origine (str) sur une ligne separee, 

comnie ceci : 

tim 

kerry 

timmy 

camden 

Notez que les virgules sont supprimees (elles ne sont pas 
imprimees). La classe StringTokenizer peut etre constmite 
avec un, deux ou trois parametres. Lorsqu'elle est appelee 
avec un seul parametre, le parametre correspond a la 
chaine a diviser. Dans ce cas, le delimiteur utilise corres- 
pond aux limites naturelles de mot par defaut. Le tokenizer 
utilise ainsi le jeu de delimiteurs " \t\n\r\f " (le caractere 
d'espace, le caractere de tabulation, le caractere de nou- 
velle ligne, le caractere de retour chariot et le caractere 
d'avancement de page). 

Le deuxieme moyen de construire un objet StringToke- 
nizer consiste a passer deux parametres au constructeur. 
Le premier parametre correspond alors a la chaine a 
decomposer et le second a la chaine contenant les delimi- 
teurs en fonction desquels la chaine doit etre divisee. Ce 
parametre vient remplacer les delimiteurs par defaut. 

Pour finir, vous pouvez passer un troisieme argument au 
constructeur StringTokenizer qui indique si les delimi- 
teurs doivent etre retournes sous forme de jetons ou sup- 
primes. Ce parametre est booleen. Si vous passez la valeur 
true, les delimiteurs sont retournes sous forme de jetons. 
Par defaut, le parametre vaut false. II supprime les deli- 
miteurs et ne les traite pas comme des jetons. 
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Examinez aussi les exemples du Chapitre 6. Avec l'ajout 
du support des expressions regulieres en Java propose par 
le JDK 1.4, il devient souvent possible d'utiliser des 
expressions regulieres au lieu de la classe StringTokenizer. 
La documentation JavaDoc oflicielle stipule que la classe 
StringTokenizer est une classe heritee dont l'usage doit 
etre deconseille dans le nouveau code. Dans la mesure du 
possible, utilisez done la methode split () de la classe 
String ou le paquetagejava pour les expressions regulieres. 
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Travailler avec des 
structures de donnees 



On appelle "structure de donnees" un dispositif servant a 
organiser les donnees utilisees par un programme. Chaque 
fois que vous travaillez avec des groupes d'elements de 
donnees similaires, il est judicieux d'utiliser une structure 
de donnees. Le Java offre une excellente gestion des diffe- 
rents types de structures de donnees, dont les tableaux, les 
listes, les dictionnaires et les ensembles. La plupart des 
classes Java servant a travailler avec les structures de don- 
nees sont livrees dans le framework Collections, une archi- 
tecture unifiee pour la representation et la manipulation 
de collections ou de structures de donnees. Les classes de 
structure de donnees les plus couramment utilisees sont 
ArrayList et HashMap. La plupart des exemples de ce cha- 
pitre s'y referent. 

L'expression "structure de donnees" peut s'appliquer a la 
maniere dont les donnees sont ordonnees dans un fichier 
ou une base de donnees tout autant qu'en memoire. Tous 
les exemples de ce chapitre traitent des structures de don- 
nees en memoire. 
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Info 

Sun met a disposition un document (en anglais) qui offre une 
bonne vue d'ensemble du framework Collections et propose des 
didacticiels sur I'utilisation des differentes classes. Pour consul- 
ter ce document, rendez-vous a I'adresse suivante : http:// 
java.sun.com/j2se/1.5.0/docs/guide/collections/index.html. 



Redimensionner un tableau 



// Utiliser un ArrayList 

List myArray = new ArrayList(); 



En Java, les tableaux d'objets normaux ou de types prinii- 
tifs ne peuvent pas etre redimensionnes de maniere dyna- 
mique. Si vous souhaitez qu'un tableau soit agrandi par 
rapport a sa declaration d'origine, vous devez declarer un 
nouveau tableau plus grand, puis copier le contenu du 
premier tableau dans le nouveau. La procedure peut pren- 
dre la forme suivante : 
int[] tmp = new int [myArray . length + 10]; 
System. arraycopy(myArray, 0, tmp, 0, myArray. length) ; 
myArray = tmp; 

Dans cet exemple, nous souhaitons agrandir la taille d'un 
tableau d'entiers appele myArray arm de lui ajouter dix ele- 
ments. Nous creons done un nouveau tableau appele tmp et 
l'initialisons en lui attribuant la longueur de myArray + 1 0. 
Nous utilisons ensuite la methode System. arrayCopy( ) 
pour copier le contenu de myArray dans le tableau tmp. 
Pour finir, nous positionnons myArray de maniere a ce 
qu'il pointe sur le tableau tmp nouvellement cree. 

En general, la meilleure solution pour ce type de pro- 
bleme consiste a utiliser un objet ArrayList au lieu d'un 
tableau d'objets classique. L'objet ArrayList peut contenir 



Parcourir une collection en boucle 



n'importe quel type d'objet. Son principal interet tient a 
ce qu'il se redimensionne automatiquement selon les 
besoins. Lorsque vous utilisez un ArrayList, vous n'avez 
plus a vous soucier de la taille de votre tableau en vous 
demandant si vous risquez de manquer de place. L'imple- 
mentation ArrayList est en outre bien plus efficace que 
la methode precedente qui consiste a copier le tableau a 
rediniensionner dans un nouveau tableau. L'objet Array- 
List fait partie du paquetage java.util. 



Parcourir une collection en boucle 



// Pour un ensemble ou une liste 

// collection est l'objet set ou list 

for (Iterator it= collection. iterator() ; it.hasNext(); ) 

{ 

Object element = it.next(); 

} 

// Pour les cles d'un dictionnaire 

for (Iterator it = map.keySet() .iterator)) ; it.hasNext(); 
) { 

Object key = it.next(); 

} 

// Pour les valeurs d'un dictionnaire 

for (Iterator it = map.values() .iterator)) ; it.hasNext(); 

) { 

Object value = it.next(); 

} 

// Pour les cles et les valeurs d'un dictionnaire 
for (Iterator it = map. entrySet() .iterator () ; 
it.hasNext(); ) { 

Map. Entry entry = (Map. Entry) it. next() ; 

Object key = entry. getKey() ; 

Object value = entry. ge t Value ( ) ; 

} 
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Le paquetage java.util contient une classe Iterator qui 
facilite le parcours en boucle des collections. Pour par- 
courir en boucle un objet collection, vous devez d'abord 
obtenir un objet Iterator en appelant la methode itera- 
tor() de l'objet collection. Lorsque vous avez l'objet 
Iterator, il ne reste plus qu'a le parcourir pas a pas avec la 
methode next(). Cette methode retourne l'element sui- 
vant de la collection. 

La methode next() retourne un type Object generique. 
Vous devez done transtyper la valeur de retour afin de lui 
attribuerle type attendu. La methode hasNext( ) vous per- 
met quant a elle de verifier s'il existe d'autres elements qui 
n'ont pas encore ete traites. En combinant ces deux 
methodes, vous pouvez ainsi aisement creer une boucle 
for pour parcourir un a un chacun des elements d'une 
collection, comme le montre l'exemple precedent. 

L'exemple precedent indique aussi comment parcourir en 
boucle un ensemble ou une liste, les cles d'un diction- 
naire, les valeurs d'un dictionnaire et les cles et les valeurs 
d'un dictionnaire. 

Info 

Les iterateurs peuvent etre utiles pour exposer des collections 
via une API. L'avantage qu'apporte I'exposition des donnees a 
I'aide d'un iterateur tient a ce que le code appelant n'a pas a se 
soucier de la maniere dont les donnees sont stockees. Cette 
implementation permet de changer le type de collection sans 
avoir a modifier I'API. 



Creer une collection mappee 



Creer une collection mappee 



HashMap map = new HashMap(); 
map. put ( key 1 , objl); 
map.put(key2, obj2); 
map.get(key3, obj3); 



Cet exemple utilise un HashMap pour creer une collection 
mappee d'objets. Le HashMap possede une methode put() 
qui prend deux parametres. Le premier est une valeur de 
cle et le second l'objet que vous souhaitez stocker dans le 
dictionnaire. Dans cet exemple, nous stockons done trois 
objets (objl, ob]2 et obj3) en les indexant avec des cles 
(respectivement keyl, key2 et key3). La classe HashMap est 
l'une des classes Java les plus couramment utilisees. Dans 
un HashMap, les objets places dans un dictionnaire doivent 
tous etre du meme type de classe. Si obj 1 est un objet 
String, ob]2 et ob]3 doivent done egalement etre des 
objets String. 

Pour recuperer les objets places dans la collection, vous 
utilisez la methode get ( ) du HashMap. Elle prend un unique 
parametre correspondant a la cle de l'element a recuperer. 
Si l'element est trouve, il est retourne sous forme d'objet 
generique Ob j ect : il faut done le transtyper pour lui attri- 
buer le type desire. Si 1' element que vous tentez de 
recuperer n'existe pas, la valeur null est retournee. 

Info 

Le JDK 1.5 introduit une nouvelle fonctionnalite du langage, 
les generiques, permettant de recuperer des elements d'un Has- 
hMap sans avoir a realiser de transtypage. Sun propose un 
excellent article sur I'utilisation des generiques a I'adresse 
suivante : http://java.sun.com/developer/technicalArticles/J2SE 
/generics/index.html. 
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Les objets utilises comme valeurs de cle dans un HashMap 
doivent implementer les methodes equals ( ) et hashCode ( ) . 
Ces methodes sont utilisees par Fimplementatian HashMap 
pour retrouver les elements dans le dictionnaire. Si elles 
ne sont pas implementees dans un objet utilise comme 
valeur de cle, les objets cles sont retrouves en fonction 
de leur identite uniquement. Dans ce cas, pour trouver 
une cle concordante, vous devrez passer l'instance d'objet 
elle-meme lorsque vous essayerez de recuperer un objet : 
a priori, ce n'est pas le but recherche ! 

Stocker une collection 



// Trier un tableau 

int[] mylnts = {1,5,7,8,2,3}; 

Arrays. sort(mylnts) ; 

// Trier une liste 

List myList = new Array List(); 

myList.put(objl); 

myList. put(obj2); 

Collections . sort (myList ) ; 



La classe Arrays est une classe du paquetage java.util 
contenant un grand nombre de methodes statiques servant 
a manipuler des tableaux. La plus utile d'entre elles est sans 
doute la methode sort ( ) . Cette methode prend un tableau 
d'objets ou de types primitifs et des index de debut et de 
fin. L'index de debut specifie l'index du premier element 
a trier et l'index de fin celui du dernier element a trier. 

Les primitifs sont tries par ordre croissant. Lorsque 
cette methode est utilisee pour trier des objets, tous 
les objets doivent implementer l'interface Comparable, 
a defaut de quoi un objet Comparator peut etre passe. 
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Dans l'exemple precedent, nous commencons avec un 
tableau d'entiers de type int. Nous passons ce tableau a la 
methode Arrays . sort ( ) qui le trie. Notez bien que c'est 
le tableau lui-meme qui est passe : il est done directement 
trie et modifie. La methode sort() ne retourne pas de 
nouveau tableau trie : son type de retour est void. 

La classe Collections, autre classe du paquetage java.util, 
contient des methodes statiques qui operent sur d'autres 
objets de collection. La methode sort ( ) prend un objet 
List en entree et trie les elements dans la liste par ordre 
croissant, selon l'ordre naturel des elements. Comme avec 
la methode sort() de l'objet Arrays, tous les elements 
dans l'objet List passe a la methode doivent implementer 
l'interface Comparable a defaut de quoi un objet Compara- 
tor peut etre passe avec l'objet List. La liste passee a la 
methode sort() est elle-meme modifiee. 

Dans la seconde partie de notre exemple, nous creons un 
objet ArrayList et utilisons la methode Collec- 
tions, sort () pourle trier. Dans cet exemple, aucun objet 
Comparator n'a ete passe, aussi les objets obj 1 et ob]2 doi- 
vent imperativement implementer l'interface Comparable. 

Si l'ordre de tri par defaut ne vous convient pas, vous 
pouvez implementer l'interface Comparator pour definir 
votre propre mecanisme de tri. Le comparateur que vous 
definissez peut ensuite etre passe comme second argument 
a la methode sort ( ) de la classe Collections ou Arrays. 

En plus des classes que nous venons de citer, le fra- 
mework Collections contient des classes dont le tri est 
inherent, comme les objets TreeSet et TreeMap. Si vous 
utilisez ces classes, les elements sont automatiquement 
tries lorsqu'ils sont places dans la collection. Dans le cas 
d'un TreeSet, les elements sont tries par ordre croissant 
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d'apres l'interface Comparable ou d'apres le Comparator 
fourni au moment de la creation. Dans le cas d'un TreeMap, 
les elements sont tries par ordre croissant de cle d'apres 
l'interface Comparable ou d'apres le Comparator fourni au 
moment de la creation. 

Trouver un objet 
dans une collection 



// Trouver un objet dans un ArrayList 

int index = myArrayList.indexOf (myStringObj ) ; 

// Trouver un objet par valeur dans un HashMap 
myHashMap . containsValue ( myStringOb j ) ; 

// Trouver un objet par cle dans un HashMap 
myHashMap. containsKey(myStringObj ) ; 



Ces exemples montrent comment retrouver des objets 
dans les collections les plus couramment utilises : Array- 
List et HashMap. La methode indexOf () de 1' objet Array- 
List permet de retrouver la position dans le tableau a 
laquelle se trouve un objet particulier. Si 1' objet passe a la 
methode indexOf ( ) n'est pas retrouve, la methode 
retourne-1. L'objet HashMap indexe les elements par 
objets et non par valeurs entieres comme le fait l'objet 
ArrayList. Les methodes containsValue ( ) ou contains- 
Key ( ) peuvent etre utilisees pour determiner si le HashMap 
contient l'objet passe comme valeur ou comme cle dans le 
dictionnaire. Elles retournent une valeur booleenne. 

Deux autres methodes, binarySearch( ) et contains)), 
permettent egalement de retrouver des objets dans des 
collections. La methode binarySearch ( ) est une methode 
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des classes utilitaires Arrays et Collections. Elle effectue 
une recherche dans un tableau selon l'algorithme de 
recherche binaire. Le tableau doit etre trie avant d'appeler 
la methode binarySearch ( ) de la classe Arrays. Sans cela, 
les resultats sont indefinis. Le tri du tableau peut etre rea- 
lise avec la methode Arrays.sort(). Si le tableau contient 
plusieurs elements possedant la valeur specifiee comme 
valeur de recherche, rien ne permet de determiner celui 
qui sera retrouve. Selon la meme logique, la methode 
binarySearch ( ) de la classe Collections ne doit etre utili- 
see que sur une collection deja triee par ordre croissant 
selon l'ordre naturel de ses elements. Ce tri peut etre rea- 
lise avec la methode Collections . sort ( ) . Comme pour les 
tableaux, l'emploi de binarySearch ( ) sur une collection 
non triee produit des resultats indefinis. S'il existe plusieurs 
elements correspondant a l'objet recherche, rien ne per- 
met non plus de determiner celui qui sera retrouve. 

Lorsque la collection n'est pas deja triee, il peut etre 
preferable d'utiliser la methode indexOf () plutot que de 
realiser le tri (sort()) puis la recherche binaire (binary- 
Search ()). L'operation de tri (sort()) peut etre couteuse 
dans le cas de certaines collections. 

L'exemple suivant utilise la methode binarySearch ( ) pour 
effectuer une recherche dans un tableau d'entiers : 
int[] mylnts = new int[]{7, 5, 1, 3, 6, 8, 9, 2}; 
Arrays. sort(mylnts) ; 

int index = Arrays . binarySearch(myInts, 6); 

System. out. println ( "Value 6 is at index: " + index); 

Ce code produit la sortie suivante : 
The value 6 is at index 4. 
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La classe ArrayList possede egalement une methode 
contains ( ) qui peut etre utilisee pour verifier si un objet 
donne est membre d'un ArrayList donne. 

Convertir une collection 
en un tableau 



// Convertir un ArrayList en un tableau d'objets 
Object[] objects = aArrayList.toArray() ; 

// Convertir un HashMap en un tableau d'objets 
Object[] mapObjects = aHashMap.entrySet().toArray(); 



Comme le montre cet exemple, il est assez simple en Java 
de convertir une collection telle qu'un ArrayList ou un 
HashMap en un tableau d'objets standard. 

L'objet ArrayList possede une methode toArray() qui 
retourne un tableau d'objets. La conversion d'un HashMap 
en un tableau est legerement differente. II faut d'abord 
obtenir les valeurs stockees dans le HashMap sous forme de 
tableau en utilisant la methode entrySet ( ) . 

La methode entrySet () retourne les valeurs de donnees 
sous forme de Set Java. Une fois que l'objet Set est 
obtenu, nous pouvons appeler la methode toArray ( ) pour 
recuperer un tableau contenant les valeurs stockees dans le 
HashMap. 
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Dates et heures 



La plupart des programmes Java sont immanquablement 
conduits a devoir gerer des dates et des heures a un 
moment ou un autre. Fort heureusement, la gestion des 
dates et des heures est fort bien integree a Java. Trois clas- 
ses principales sont utilisees dans la plupart des program- 
mes pour stocker et manipuler les heures et les dates : 
java.util.Date, j ava. sql . Date et j ava . util . Calendar. 

Bon nombre des methodes de la classe java.util.Date 
sont maintenant deconseillees : vous devez done eviter de 
les utiliser pour vos nouveaux projets de developpement. 
Les methodes deconseillees concernent pour la plupart la 
creation et la manipulation des dates. Dans le cas de ces 
operations, il est preferable d'utiliser le mecanisme de la 
classe j ava. util . Calendar. Les conversions entre les 
objets Date et Calendar sont faciles. Si vous preferez passer 
vos dates sous forme d'objets Date, il est done parfaite- 
ment possible d'eviter les methodes deconseillees. Vous 
devez alors simplement convertir vos dates en objets 
Calendar au moment de les manipuler. L'un des exemples 
de ce chapitre montre comment effectuer la conversion 
entre les objets Date et les objets Calendar. 
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Retrouver la date d'aujourd'hui 



Date today = new java.util.Date(); 

System. out. println( "Today's Date is " + today. toString() ) ; 



II est imperatif que vous soyez familiarise avec l'objet Date 
du paquetage java.util si vos programmes traitent avec 
des dates et des heures, car cet objet est tres frequemment 
utilise. II permet notamment de recuperer tres simple- 
ment la date et l'heure courantes. Lorsque vous creez une 
instance de l'objet Date, celle-ci est initialisee avec l'heure 
et la date courantes. 

La classe Calendar propose une autre methode pour 
recuperer la date et l'heure courantes, comme ceci : 

Calendar cal = Calendar. getlnstance( ) ; 

Cette ligne produit un objet Calendar nomine cal et l'ini- 
tialise avec la date et l'heure courantes. 

Conversion entre les objets 
Date et Calendar 



// Conversion de Date a Calendar 
Date myDate = new java.util. Date () ; 
Calendar myCal = Calendar. getlnstance() ; 
myCal.setTime(myDate) ; 

// Conversion de Calendar a Date 
Calendar newCal = Calendar. getlnstance() ; 
Date newDate = newCal.getTime(); 



En travaillant avec des heures et des dates, vous constate- 
rez souvent qu'il est necessaire d'effectuer une conversion 
entre des objets Java Date et Calendar. Cette tache est 
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heureusement tres simple, comme en atteste l'exemple 
precedent. L'objet Calendar possede une methode set- 
Time () qui prend un objet java.util.Date en entree et 
positionne l'objet Calendar en lui attribuant la date et 
l'heure contenues dans l'objet Date passe. Pour la conver- 
sion inverse, vous pouvez utiliser la methode getTime() 
de la classe Calendar qui retourne la date et l'heure du 
calendrier sous forme d'objet java.util.Date. 

La plupart des applications Java se servent des classes Date 
et Calendar. De la l'importance qu'il y a a se familiariser 
avec le processus de conversion d'un type vers l'autre. II 
est conseille de creer des methodes utilitaires pour realiser 
ces conversions afin de pouvoir les utiliser depuis 
n'importe quel emplacement du code au moyen d'un 
simple appel de methode. Voici des methodes simples 
pour la conversion des objets Calendar en objets Date et 
des objets Date en objets Calendar : 

public static Date calToDate(Calendar cal) { 
return cal. getTime( ) ; 

} 

public static Calendar dateToCal(Date date) { 
Calendar myCal = Calendar .getlnstance () ; 
myCal.setTime(date) ; 
return myCal; 

} 
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Imprimer une date/une heure 
dans un format specifie 



Date todaysDate = new java.util.Date() ; 
SimpleDateFormat formatter = 

new SimpleDateFormat ("EEE, dd MMM yyyy HH:mm:ss"); 
String formattedDate = formatter. format(todaysDate) ; 
System. out. println( "Today's Date and Time is: " + 
"•formattedDate) ; 



Le Java contient des classes de formatage qui peuvent etre 
utilisees pour appliquer a une date un format desire. La 
classe la plus couramment utilisee pour le formatage des 
dates est la classe SimpleDateFormat. Elle prend une chaine 
de format en entree de son constructeur et retourne un 
objet de format qui peut etre utilise ensuite pour formater 
des objets Date. La methode format ( ) de l'objet SimpleDa- 
teFormat retourne une chaine contenant la representation 
formatee de la Date passee en parametre. 

Voici la sortie de l'exemple precedent : 

Today's Date and Time is: jeu., 04 janv. 2007 16:48:38 

La chaine de format passee au constructeur SimpleDate- 
Format peut paraitre un peu obscure si vous ne connaissez 
pas les codes de formatage a utiliser. Le Tableau 5.1 pre- 
sente les codes qui peuvent etre passes au constructeur de 
SimpleDateFormat. Dans notre exemple, nous avons utilise 
la chaine de format suivante : 

"EEE, dd MMM yyyy HH:mm:ss" 

Decomposons cette chaine en nous referant au Tableau 5.1, 
afm de comprendre le format demande : 

■ EEE : representation sur trois caracteres du jour de la 
semaine (par exemple, Mar). 

■ , : place une virgule dans la sortie. 
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■ dd : representation sur deux caracteres du jour du mois 
(01 a 31). 

■ MMM : representation sur trois caracteres du mois de 
l'annee (par exemple, Jul). 

' yyyy : representation sur quatre caracteres de l'annee 
(par exemple, 2006). 

■ HH:mm:ss : heure, minutes et secondes, separees par des 
deux-points (par exemple, 11 : 18:33). 

Ces elements combines produisent la chaine de date 
suivante : 

jeu., 04 janv. 2007 16:48:38 

Tableau 5.1 : Codes de format de date et d'heure 



Lettre 


Composant de 
date ou d'heure 


Presentation 


Exemples 


G 


Designateur d'ere 


Texte 


AD 


y 


Annee 


Annee 


1996 ; 96 


M 


Mois de l'annee 


Mois 


Juillet ; Jul ; 07 


w 


Semaine de l'annee 


Nombre 


27 


W 


Semaine du mois 


Nombre 


2 


D 


Jour de l'annee 


Nombre 


189 


d 


Jour du mois 


Nombre 


10 


F 


Jour de la semaine 
dans le mois 


Nombre 


2 


E 


Jour de la semaine 


Texte 


Mardi ; Mar 


a 


Marqueur 
A.M. /P.M. 


Texte 


PM 
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Tableau 5.1 : Codes de format de date et d'heure (suite) 



Lettre 


PfKYinncant m o 
l_U 1 1 1 pUid 1 1 L UC 

date ou d'heure 


Presentation 


Exemples 


H 


Heure du 
jour (0 a 23) 


Nombre 


0 


k 


Heure du 
jour (1 a 24) 


Nombre 


24 


K 


Heure au format 
A.M./P.M. (0 a 11) 


Nombre 


0 


h 


Heure au format 
A.M./P.M. (1 a 12) 


Nombre 


12 


m 


Minutes 
dans l'heure 


Nombre 


30 


s 


Secondes 
dans la minute 


Nombre 


55 


S 


Millisecondes 


Nombre 


978 


z 


Fuseau horaire 


Fuseau horaire 
general 


Pacific 

Standard Time ; 
PST ; GMT-08:00 


Z 


Fuseau horaire 


Fuseau horaire 
RFC 822 


-0800 



En plus de creer vos propres chaines de format, vous 
pouvez utiliser l'une des chaines de format predefinies 
avec les methodes getTimeInstance( ), getDateInstance( ) 
ou getDateTimeInstance( ) de la classe DateFormat. Par 
exemple, le code suivant retourne un objet formateur qui 
utilisera un format de date pour vos parametres regionaux 
par defaut : 

DateFormat df = DateFormat .getDateInstance( ) ; 



Parser des chaines en dates 
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Le formateur df peut ensuite etre utilise exactenient 
comme nous avons utilise l'objet SimpleDateFormat dans 
notre exemple precedent. Consultez la documentation 
JavaDoc disponible pour la classe DateFormat pour obte- 
nir des informations detaillees sur les objets de forma- 
tage d'heure et de date standard disponibles a l'adresse 
http:/ /java.sun.com/j2se/1.5.0/ docs/ api/java/ text/ 
DateFormat.html. 

Parser des chaines en dates 



String dateString = "January 12, 1952 or 3:30:32pm"; 
DateFormat df = DateFormat.getDatelnstance(); 
Date date = df .parse(dateString) ; 



L'objet DateFormat est utilise pour parser un objet String 
et obtenir un objet java.util.Date. La methode getDa- 
telnstance() cree un objet DateFormat avec le format de 
date standard de votre pays. Vous pouvez ensuite utiliser 
la methode parse() de l'objet DateFormat retourne pour 
parser votre chaine de date et obtenir un objet Date, 
comme le montre cet exemple. 

La methode parse () accepte aussi un second parametre 
qui specifie la position dans la chaine a partir de laquelle 
l'analyse doit etre effectuee. 

Les classes java.sql.Date, java.sql.Time et java.sql 
.Timestamp contiennent une methode statique appelee 
valueOf ( ) qui peut egalement etre utilisee pour parser des 
chaines de date simples au format aaaa-mm-jj. Elles sont 
tres utiles pour convertir en objets Date des dates utilisees 
dans des chaines SQL avec des objets JDBC. 
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Ces techniques sont utiles pour convertir des donnees de 
date entrees par l'utilisateur en objets Date Java pour un 
traitement ulterieur dans votre application. Vous pou- 
vez recuperet" les dates entrees par l'utilisateur sous forme 
de chaine et les convertir en objets Date a l'aide de ces 
techniques. 

Additions et soustractions 

avec des dates ou des calendriers 



// Arithmetique de dates utilisant des objets Date 

Date date = new Date(); 

long time = date.getTime() ; 

time += 5*24*60*60*1000; 

Date futureDate = new Date(time) ; 

// Arithmetique de dates utilisant des objets Calendar 
Calendar nowCal = Calendar. getlnstance() ; 
nowCal.add(Calendar.DATE, 5); 



Si vous utilisez un objet Date, la technique d'ajout ou de 
soustraction des dates consiste a convertir d'abord l'objet 
en une valeur long en utilisant la methode getTime() de 
l'objet Date. La methode getTime() retourne l'heure 
mesuree en millisecondes depuis le debut de "l'ere" 
UNIX (l er janvier 1970, 00 h 00 s 00 ms GMT). Ensuite, 
vous devez realiser l'operation arithmetique avec des 
valeurs long et reconvertir le resultat en objet Date. Dans 
l'exemple precedent, nous ajoutons 5 jours a l'objet Date. 
Nous convertissons les 5 jours en millisecondes en multi- 
pliant 5 par le nombre d'heures dans une journee (24), le 
nombre de minutes dans une heure (60), le nombre de 
secondes dans une minute (60) et finalement par 1 000 
pour convertir les secondes en millisecondes. 



Calculer la difference entre deux dates 49 

Les operations arithmetiques de date peuvent etre rea- 
lisees directement sur des objets Calendar en utilisant la 
methode add ( ) . Cette methode prend deux parametres, 
un champ et une quantite, tous deux de type int. La 
quantite specifiee est ajoutee au champ specific. Le champ 
peut correspondre a n'importe quel champ de date valide, 
comme unjour, une semaine, un mois, une annee, etc. 
Pour soustraire une heure, vous devez utiliser une valeur 
negative. En positionnant le parametre de champ a la 
constante Calendar appropriee, vous pouvez directement 
ajouter ou soustraire des jours, des semaines, des mois, des 
annees, etc. La seconde partie de l'exemple precedent 
montre comment ajouter 5 jours a un objet Calendar. 

Calculer la difference 
entre deux dates 



long timel = datel .getTime() ; 
long time2 = date2.getTime() ; 
long dif f = time2 - timel ; 
System. out. println( "Difference in days = " + 
*»diff/ (1000*60*60*24) ) ; 



Cet exemple convertit deux objets de date datel et date2 
en millisecondes — chacun represents; sous forme de long. 
La difference est calculee en soustrayant timel a time2. La 
difference calculee en jours est ensuite imprimee en rea- 
lisant l'operation arithmetique necessaire pour convertir la 
difference en millisecondes en une difference en jours. 

II arrivera souvent que vous souhaitiez determiner la 
duree qui separe deux dates, par exemple en calculant le 
nombre de jours restants avant l'expiration d'un produit. 
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Si vous connaissez la date d'expiration d'un produit, vous 
pouvez calculer le nombre de jours avant expiration en 
calculant la difference entre la date d'expiration et la date 
courante. 

Voici un exemple de methode pour realiser ce calcul : 
public static void daysTillExpired (Date expDate) { 

Date currentDate = new Date(); 

long expTime = expDate .getTime( ) ; 

long currTime = currentDate. getTime( ) ; 

long diff = expTime - currTime; 

return dif f/ ( 1 000*60*60*24) ; 

} 

Cette methode prend une date d'expiration en entree et 
calcule le nombre de jours jusqu'a la date d'expiration. 
Cette valeur en jours est retournee par la methode. Elle 
peut fournir un nombre negatif si la date d'expiration est 
depassee. 

Comparer des dates 



if (datel .equals (date2) ) { 

System. out. print In ("dates are the same."); 

} 

else { 

if (datel. before(date2)) { 
System. out. println(" datel before date2"); 

} 

else { 

System. out. println(" datel after date2"); 

} 

} 
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Cet exemple utilise les methodes equals () et before () de 
la classe Date. La methode equals () retourne true si les 
valeurs de donnees sont les memes. Sinon, elle retourne 
false. Les dates doivent etre les memes a la milliseconde 
pres pour que la methode equals () retourne true. La 
methode bef ore( ) retourne true si la date sur laquelle elle 
est appelee intervient avant la date qui lui est passee en 
parametre. 

La classe Date possede egalement une methode after qui 
est utilisee de maniere analogue a la methode before () 
pour determiner si la date a partir de laquelle elle est appe- 
lee intervient apres la date passee en parametre. 

La methode compareTo( ) de la classe Date est aussi utile 
pour comparer deux dates. Elle prend un argument de det 
retourne une valeur d'entier. Elle retourne 0 si la date a 
partir de laquelle elle est appelee equivaut a celle passee en 
argument, une valeur negative si elle lui est anterieure et 
une valeur positive si elle lui est ulterieure. 

Retrouver le jour de la semaine/ 
du mois/de I'annee ou le numero 
de la semaine 



Calendar cal = Calendar. getlnstance( ) ; 
System. out. println("Day of week: " + 
*»cal . get (Calendar . DAY_OF_WEEK) ) ; 

System. out. println( "Month : " + cal. get (Calendar. MONTH) ) ; 
System. out. printlnf'Year: " + cal. get (Calendar . YEAR) ) ; 
System. out. println( "Week number: " + 
»»cal.get(Calendar.WEEK_OF_YEAR)); 
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Vous pouvez aisement determiner des valeurs comme le 
jour de la semaine, le niois, l'annee ou le numero de 
semaine avec la methode get() de l'objet Calendar. Dans 
l'exemple precedent, nous obtenons un objet Calendar 
representant la date et l'heure courantes avec la methode 
getlnstance( ). Nous imprimons ensuite le jour de la 
semaine, le mois, l'annee puis la semaine de l'annee en 
utilisant la methode get ( ) et en passant la constante 
Calendar appropriee pour specifier le champ a recuperet - . 

Pour obtenir ces valeurs avec un objet Date, vous devez 
d'abord convertir l'objet Date en un objet Calendar en 
utilisant la methode setTime( ) d'une instance Calendar et 
en passant l'objet Date a convertir. La conversion entre les 
objets Date et Calendar a ete presentee precedemment 
dans ce chapitre. 



Calculer une duree ecoulee 



long start = System. currentTimeMillis( ) ; 
// Realiser une autre action... 
long end = System. currentTimeMillis( ) ; 
long elapsedTime = end - start; 



En calculant une duree ecoulee, vous pouvez determiner 
le temps requis pour realiser une action ou le temps de 
progression d'un processus. Pour cela, vous devez utiliser 
la methode System. currentTimeMillis() afin d'obtenir 
l'heure courante en millisecondes. Cette methode doit etre 
utilisee au debut et a la fin de la tache a chronometrer, afin 
de calculer la difference entre les deux mesures. La valeur 
retoumee par la methode System. currentTimeMillis( ) 
correspond au temps ecoule depuis le l er janvier 1970, 
00 h 00 s 00 ms, en millisecondes. 
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Le JDK 1.5 introduit une methode nanoTime() dans la 
classe System, qui permet d'obtenir une mesure plus pre- 
cise encore, a la nanoseconde. Toutes les plates-formes ne 
prennent cependant pas en charge cette precision : bien 
que la methode nanoTime() soit disponible, il n'est done 
pas toujours possible de compter sur une mesure en nano- 
secondes. Ce niveau de precision est souvent utile pour 
les tests, le profilage et l'analyse des performances. 
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Retrouver des motifs 
avec des expressions 

regulieres 



Les expressions regulieres ont ete introduites en Java a la 
sortie du JDK 1.4. Les expressions regulieres specifient 
des motifs pouvant etre retrouves dans des sequences de 
caracteres. Elles sont particulierement utiles pour l'analyse 
des chaines et economisent souvent au programmeur bien 
du temps et des efforts par rapport aux solutions qui n'y 
font pas appel. Avant d'etre ajoutees au Java, elles ont ete 
utilisees pendant des annees par les programmeurs UNIX. 
Les outils UNIX standard comme sed et awk les 
emploient notamment. Les expressions regulieres sont 
aussi couramment utilisees dans le langage de programma- 
tion Perl. Leur ajout au JDK represente un interessant 
renforcement des capacites dujava. 

Dans ce chapitre, vous allez apprendre a utiliser les fonc- 
tionnalites liees aux expressions regulieres du Java afin 
de retrouver et remplacer des portions de texte ou d'en 
determiner la concordance au regard d'un modele. 
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Grace a ces acquis, vous pourrez determiner les cas ou 
l'usage d'un traitement par les expressions regulieres peut 
etre utile dans vos applications. 

Les expressions regulieres 
en Java 

Les classes Java Matcher et Pattern que vous utiliserez 
pour les operations liees aux expressions regulieres sont 
contenues dans le paquetage j ava . util . regex. Elles per- 
mettent a la fois de retrouver des sequences de caracteres 
et d'en determiner la concordance d'apres des motifs 
d'expression reguliere. Quelle difference faut-il faire entre 
"retrouver" et "determiner la concordance" ? L'operation 
de recherche permet de retrouver des correspondances 
dans une chaine. L'operation de determination de la con- 
cordance requiert que la chaine entiere soit une corres- 
pondance precise de l'expression reguliere. 

Les taches pour lesquelles vous faisiez auparavant appel a 
la classe StringTokenizer sont en general toutes designees 
pour etre simplifiees a l'aide d'expressions regulieres. 

Info 

Si vous ne pouvez pas utiliser une version de Java contenant 
le paquetage des expressions regulieres (autrement dit, une 
version 1.4 ou ulterieure), il existe une bonne solution de 
remplacement avec le paquetage Jakarta RegExp d'Apaehe. 
Ce livre ne eouvre pas le paquetage Jakarta, mais vous trou- 
verez des informations et une documentation complete le 
concernant a I'adresse http://jakarta.apache.org/regexp. 
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Le Tableau 6.1 presente les caracteres speciaux courants 
utilises dans les expressions regulieres. Vous pourrez vous 
referer a ce tableau en consultant les exemples du chapitre. 

Tableau 6.1 : Tableau des expressions regulieres 
- caracteres speciaux couramment utilises 

Caractere Description 
specifique r 





Debut de la chaine 


$ 


Fin de la chaine 


? 


0 ou 1 fois (fait reference a l'expression 




reguliere precedente) 


* 


0 ou plusieurs fois (fait reference 




a l'expression reguliere precedente) 


+ 


1 ou plusieurs fois (fait reference 




a l'expression reguliere precedente) 


[...] 


Classe de caracteres 


I 


Operateur union 




N'importe quel caractere 


\d 


Un chiffre 


\D 


Caractere autre qu'un chiffre 


\s 


Caractere d'espace blanc (espace, tabulation, 




nouvelle ligne, saut de page, retour chariot) 


\s 


Caractere autre qu'espace blanc 


\w 


Caractere de mot [a-zA-Z_0-9] 


\W 


Caractere autre qu'un caractere de mot ["\w] 
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Dans le Tableau 6.1, les expressions regulieres echappees 
sont presentees en etant precedees par une unique barre 
oblique inversee. Notez cependant qu'a l'interieur des 
chaines Java, il convient d'utiliser deux barres obliques 
inversees a chaque fois. Le caractere de barre oblique 
inversee possede en efFet une signification speciale en 
Java : la double barre oblique inversee echappe des lors le 
caractere de barre oblique inversee et equivaut a un uni- 
que caractere de barre oblique inversee. 

La JavaDoc de la classe Pattern propose une liste plus 
complete des caracteres utilises pour exprimer des expres- 
sions regulieres. Elle est disponible a l'adresse suivante : 
http://java.sun.eom/j2se/l.5.0/docs/api/java/util/ 
regex/Pattern.html. 

Retrouver une portion de texte 
a I'aide d'une expression reguliere 



String pattern = "[TJ]im"; 
Pattern regPat = Pattern. compile ( pattern ) ; 
String text = "This is jim and Timothy."; 
Matcher matcher = regPat.matcher(text) ; 
if (matcher. find()) { 
String matchedText = matcher. group() ; 

} 



Cet exemple utilise les classes Pattern et Matcher. Pour 
commencer, nous utilisons la methode compile () de la 
classe Pattern afin de compiler une chaine de motif en un 
objet Pattern. Une fois que nous avons l'objet Pattern 
regPat, nous utilisons la methode matcher () et passons la 
chaine de texte en fonction de laquelle la correspondance 
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doit etre etablie. La methode matcher() retourne une ins- 
tance de la classe Matcher. Pour finir, nous appelons la 
methode group ( ) de la classe Matcher pour obtenir le texte 
correspondant. Le texte correspondant dans cet exemple 
est la chaine "Tim". Notez que la chaine "jim" n'est pas 
une occurrence correspondante, car par defaut, les expres- 
sions regulieres tiennent compte de la casse des caracteres. 
Pour operer une recherche en ignorant la casse, ce code 
doit etre legerement modifie, comme ceci : 

String patt = "[TJ]im"; 

Pattern regPat = Pattern. compile (patt, 
• Pattern. CASE_INSENSITIVE) ; 

String text = "This is jim and Timothy."; 

Matcher matcher = regPat .matcher(text) ; 

if (matcher. f ind( ) ) { 

String matchedText = matcher. group( ) ; 

} 

Le texte retourne est maintenant la chaine de caracteres 
"jim". La mise en correspondance n'etant cette fois pas 
sensible a la casse, la premiere correspondance " j im " 
intervient avant la correspondance portant sur "Tim". 

Notez que la seule difference par rapport au precedent 
exemple tient a ce que nous avons ajoute un parametre 
supplementaire a la methode compile ( ) en creant notre 
objet Pattern. Cette fois-ci, nous passons le drapeau 
CASE_INSENSITIVE afin d'indiquer que nous souhaitons 
que la correspondance soit etablie sans tenir compte de la 
casse. Lorsque ce drapeau n'est pas inclus, la correspon- 
dance s'etablit par defaut en tenant compte de la casse. 
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Si votre code doit s'executer sous differents parametres 
regionaux, vous pouvez egalement passer le drapeau de 
casse Unicode. La ligne de compilation resseniblera alors 
a ceci : 

Pattern regPat = Pattern . compile (pattern , 
'^Pattern. CASE_INSENSITIVE | Pattern. UNICODE_CASE) ; 

Comme vous le voyez, les differents drapeaux passes a la 
methode compile () sont separes les uns des autres par un 
signe OU logique. Les drapeaux Pattern doivent etre 
passes au moment ou le Pattern est cree en utilisant la 
methode compile(). Une fois que l'objet Pattern est 
cree, il est immuable, ce qui signifie qu'il ne peut plus 
etre change. 

Dans les precedents exemples, nous avons utilise la methode 
find() de la classe Matcher pour retrouver la premiere 
correspondance dans notre chaine d'entree. La methode 
find() peut cependant etre appelee de maniere repetitive 
afin de retourner toutes les correspondances successives 
dans la chaine d'entree. La methode find( ) retourne true 
chaque fois qu'une correspondance est trouvee. Elle 
retourne false lorsqu'il n'y a plus de correspondance. Si 
vous appelez find() de nouveau apres qu'elle a retourne 
false, elle se reinitialise et retrouve la premiere occurrence 
de nouveau. II existe une autre methode f ind( ) qui prend 
un parametre int specifiant un index a partir duquel la 
recherche doit demarrer. Pour le reste, cette methode 
find ( ) se comporte exactement comme la methode find ( ) 
sans parametre. 

D'autres solutions sont possibles pour obtenir le resultat 
de la correspondance. Nous avons utilise la methode 
group() de la classe Matcher, mais il existe aussi des 
methodes pratiques start ( ) et end ( ) . La methode start ( ) 
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retourne l'index au debut de la precedente correspon- 
dance. La methode end( ) retourne l'index apres le dernier 
caractere mis en correspondance. 

Remplacer du texte 
mis en correspondance 



String pattern = "[TJ]im"; 
Pattern regPat = Pattern. compile(pattern) ; 
String text = "This is jim and Tim."; 
Matcher matcher = regPat. matcher ( text ) ; 
String string2 = matcher. replaceAll( "John" ) ; 



Cet exemple montre comment remplacer le texte 
retrouve avec notre chaine de motif par un texte de rem- 
placement. La valeur de string2 a la fin de cet exemple est 
la suivante : 

This is jim and John. 

L'occurrence de "jim" n'est pas remplacee, car la mise en 
correspondance des expressions regulieres tient par defaut 
compte de la casse. Pour etablir une correspondance en 
ignorant la casse, referez-vous a l'exercice precedent. 

Nous utilisons les classes Pattern et Matcher comme nous 
l'avons fait lors de la mise en correspondance elementaire 
de l'exercice precedent. L'etape nouvelle concerne ici 
notre appel a la methode replaceAll( ) de Matcher. Nous 
passons en parametre le texte a utiliser comme texte de 
remplacement. Celui-ci vient remplacer toutes les occur- 
rences retrouvees du motif. Cette technique est tres effi- 
cace pour remplacer des portions d'une chaine par une 
chaine de remplacement. 
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L'autre technique utile pour le remplacement du texte 
consiste a utiliser les methodes appendReplacement ( ) et 
appendTail( ) de la classe Matcher. L'usage combine de ces 
methodes permet de remplacer des occurrences d'une 
sous-chaine a l'interieur d'une chaine. Le code suivant 
presente un exemple de cette technique : 

Pattern p = Pattern. compile( "My" ) ; 
Matcher m = p.matcher( "My dad and My mom"); 
StringBuffer sb = new StringBuff er( ) ; 
boolean found = m.find(); 
while(found) { 

m.appendReplacement(sb, "Our" ) ; 

found = m.f ind( ) ; 

} 

m.appendTail(sb) ; 
System. out. println(sb) ; 

La sortie de ce code produit Pimpression de la ligne sui- 
vante avec la methode System . out . println ( ) : 

Our dad and Our mom 

Dans cet exemple, nous creons un objet Pattern afin 
de retrouver les occurrences du texte "My". La methode 
appendReplacement ( ) ecrit les caracteres de la sequence 
d' entree ("My dad and my mom") dans le tampon 
StringBuffer sb, jusqu'au dernier caractere avant la prece- 
dente correspondance. Elle ajoute ensuite au StringBuffer 
la chaine de remplacement passee en second parametre. 
Pour finir, elle fixe la position de la chaine courante au 
niveau de la fin de la derniere correspondance. Ce pro- 
cessus se repete jusqu'a ce qu'il n'y ait plus de corres- 
pondance. A ce moment-la, nous appelons la methode 
appendTail ( ) pour ajouter la portion restante de la sequence 
d'entree au StringBuffer. 
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Retrouver toutes les occurrences 
d'un motif 



String pattern = "\\st(\\w)*o(\\w)*" ; 

Pattern regPat = Pattern. compile ( pattern ) ; 

String text = "The words are town torn ton toon house."; 

Matcher matcher = regPat. matcher ( text ) ; 

while (matcher. f ind( ) ) { 

String matchedText = matcher. group() ; 

System. out. println( "match - " + matchedText); 

} 



Dans les precedents exemples du chapitre, nous n'avons 
trouve qu'une unique correspondance d'un motif. Dans 
cet exemple, nous retrouvons toutes les occurrences d'un 
motif de correspondance donne dans une chaine. Le motif 
utilise est " Wst ( \\w) *o( \ \w) * ". Cette expression reguliere 
retrouve tous les mots qui commencent par t et contien- 
nent la lettre o. La sortie imprimee par notre instruction 
System . out . println ( ) est la suivante : 

town 
torn 
ton 
toon 

Decomposons cette expression reguliere et voyons ce que 
chaque element nous apporte : 

■ \\s : caractere special d'expression reguliere corres- 
pondant a un caractere d'espace blanc. 

■ t : correspond a la lettre t. 

■ \\w* : caractere special d'expression reguliere corres- 
pondant a zero, un ou plusieurs caracteres de mot (qui 
ne sont pas des espaces blancs). 
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■ o : correspond a la lettre o. 

■ \\w* : caractere special d'expression reguliere corres- 
pondant a zero, un ou plusieurs caracteres de mot (qui 
ne sont pas des espaces blancs). 

Cette expression reguliere ne correspond pas au premier 
mot de la chaine, quand bien mane celui-ci commence- 
rait par un t et contiendrait un o, car le premier element 
de l'expression reguliere correspond a un caractere 
d'espace blanc or generalement, les chaines ne commen- 
cent pas par un espace blanc. 



Imprimer des lignes 
contenant un motif 



String pattern = ""a"; 
Pattern regPat = Pattern. compile(pattern) ; 
Matcher matcher = regPat .matcherf 1 ") ; 
BufferedReader reader = 

new BufferedReaderfnew FileReader("file.txt")); 
String line; 

while ((line = reader. readLineO) != null) { 
matcher. reset (line) ; 
if (matcher. find()) { 
System. out. println(line) ; 

} 

} 



Cet exemple montre comment effectuer une recherche 
dans un fichier afin de trouver toutes les lignes contenant 
un motif donne. Ici, nous utilisons la classe BufferedRea- 
der pour lire des lignes depuis un fichier texte. Nous ten- 
tons de mettre en correspondance chaque ligne avec notre 
motif en utilisant la methode find() de la classe Matcher. 
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Cette methode retourne true si le motif est trouve dans la 
ligne passee en parametre. Nous imprimons toutes les 
lignes qui correspondent au motif donne. Notez que ce 
fragment de code peut lever des exceptions FileNotFoun- 
dException et IOException, qu'il convient de gerer dans 
votre code. Dans cet exemple, l'expression reguliere cor- 
respond a n'importe quelle ligne contenue dans notre 
fichier d'entree qui commence par la lettre a minuscule. 

Le motif d'expression reguliere que nous utilisons se 
decompose de la maniere suivante : 

■ " : caractere special d'expression reguliere correspon- 
dant au debut d'une chaine. 

■ a : correspond a la lettre a. 

Retrouver des caracteres 

de nouvelle ligne dans du texte 



String pattern = "\\d$"; 
String text = 

"This is line 1\nHere is line 2\nThis is line 3\n"; 
Pattern regPat = 

Pattern. compile (pattern, Pattern. MULTILINE) ; 
Matcher matcher = regPat. matcher ( text ) ; 
while (matcher. f ind( ) ) { 

System . out . println (matcher . group ()) ; 

} 



Dans cet exemple, nous utilisons le drapeau Pattern. MUL- 
TILINE pour retrouver des caracteres de nouvelle ligne 
dans une chaine de texte. Par defaut, les caracteres 
d'expression reguliere " et $ ne correspondent qu'au 
debut et a la fin d'une chaine entiere. Si une chaine con- 
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tenait plusieurs lignes distinguees par des caracteres de 
nouvelle ligne, l'expression reguliere * ne correspondrait 
toujours qu'au debut de la chaine par defaut. Si nous pas- 
sons le drapeau Pattern. MULTILINE a la methode Pat- 
tern, compile () comme nous le faisons dans cet exemple, 
le caractere * correspond niaintenant au premier caractere 
suivant un terminateur de ligne et le caractere $ au carac- 
tere precedent un terminateur de ligne. Avec le drapeau 
Pattern . MULTILINE, le " correspond maintenant au debut 
de chaque ligne dans une chaine contenant plusieurs 
lignes separees par des caracteres de nouvelle ligne. 

La sortie de cet exemple est la suivante : 
1 

2 
3 

Nous utilisons le motif "\\d$". Dans cette expression 
reguliere, le \\d correspond a n'importe quel chiffre uni- 
que. En mode MULTILINE, le $ correspond au caractere 
intervenant juste avant un terminateur de ligne. L'effet 
interessant est que notre expression reguliere correspond a 
tout caractere chiffre unique present a la fin d'une ligne. 
Nous obtenons done la sortie precedente. 



7 

Nombres 



Le travail avec des nombres en Java est un domaine dans 
lequel tout bon programmeur se doit d'etre aguerri, car 
presque tous les programmes ont affaire a des nombres 
sous une forme ou une autre. Dans ce chapitre, nous 
utiliserons principalement les types numeriques de base 
du Java, leurs objets encapsuleurs (wrappers) et la classe 
j ava. lang . Math. 



Le Tableau 7.1 presente les types predefinis du Java et liste 
leurs objets encapsuleurs disponibles. Notez que le type 
booleen ne possede pas de taille en bits parce qu'il ne peut 
contenir que deux valeurs discretes, true ou false. 


Tableau 7.1 


: Types predefinis du Java 




Type 


Taille en bits 


Objet encapsuleur 


byte 


8 


Byte 


short 


16 


Short 


int 


32 


Integer 


long 


64 


Long 
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Tableau 7.1 


: Types predefinis du Java (suite) 


Type 


Taille en bits 


Objet encapsuleur 


float 


32 


Float 


double 


64 


Double 


char 


16 


Character 


boolean 




Boolean 



Les classes d'objet encapsuleur sont utiles lorsque vous 
souhaitez traiter un type de base comme un objet. Cette 
approche peut notamment etre utile si vous souhaitez 
definir une API manipulant uniquement des objets. En 
encapsulant vos nombres sous forme d'objets, vous pou- 
vez aussi serialiser les types de base. 

Verifier si une chaine 
est un nombre valide 



try { 

int result = Integer. parselnt (aString) ; 

} 

catch (NumberFormatException ex) { 
System. out. println( "The string does not contain a valid 
»»number. ") ; 

} 



Dans cet exemple, nous utilisons la methode statique 
parselnt () de la classe Integer pour tenter de convertir 
le parametre chaine en un entier. Si le parametre chaine 
ne peut pas etre converti en un entier valide, l'exception 
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NumberFormatException est levee. Si l'exception Number- 
FormatException n'est pas levee, on peut done en conclure 
a contrario que la methode parselnt ( ) est parvenue a par- 
ser la chaine en une valeur d'entier. 

II est aussi possible de declarer la variable int en dehors du 
bloc try afin de pouvoir attribuer une valeur par defaut a 
la variable dans le bloc catch si l'exception NumberFormat- 
Exception est levee. Le code devient alors le suivant : 

int result = 0; 
try { 

result = Integer. parselnt(aString) ; 

} 

catch (NumberFormatException ex) { 
result = DEFAULT_VALUE; 

} 

Comparer des nombres 
a virgule flottante 



Float a = new Float(3.0f); 
Float b = new Float(3.0f); 
if (a.equals(b)) { 
// lis sont egaux 

} 



Une prudence toute particuliere est recommandee lors de 
la comparaison des nombres a virgule flottante en raison 
des erreurs d'arrondi. Au lieu de comparer les types Java 
de base a virgule flottante float et double avec l'operateur 
==, il est preferable de comparer leurs equivalents objet. La 
methode equals () de Float et Double retourne true si et 
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seulement si les deux valeurs sont exactement identiques 
au bit pres ou si elles correspondent toutes deux a la valeur 
NaN. Cette valeur designe une valeur autre qu'un nombre 
(NaN pour not a number) — qui n'est pas un nombre valide. 

En pratique, lors de la comparaison des nombres a virgule 
flottante, il n'est pas toujours souhaitable d'effectuer une 
comparaison exacte. II est parfois plus judicieux de la fixer 
a une plage differentielle acceptable, aussi appelee tole- 
rance. Les classes et les types Java ne possedent malheureu- 
sement pas de fonctionnalite predefinie de ce type, mais 
vous pouvez assez aisement creer votre propre methode 
equals () pour cela. Voici un fragment de code qui peut 
etre utilise pour creer une methode de ce type : 

float f1 = 2.99f; 
float f2 = 3.00f; 
float tolerance = 0.05f; 

if (f1 == f2) System. out . println ( "they are equal"); 
else { 

if (Math.abs(f1-f2) < tolerance) { 
System. out . println ( "within tolerance" ) ; 

} 

} 

Nous comparons d'abord les nombres a virgule flottante 
en utilisant Poperateur ==. S'ils sont egaux, nous impri- 
mons un message correspondant. S'ils ne le sont pas, nous 
verifions si la valeur absolue de leur difference est infe- 
rieure a la valeur de tolerance desiree. Cette technique 
permet de creer une methode utile prenant en parametre 
deux valeurs a virgule flottante et une tolerance, et 
retournant un resultat indiquant si les valeurs sont egales, 
a la plage de tolerance pres. 
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Arrondir des nombres 
a virgule flottante 



// Arrondir une valeur double 

long longResult = Math. round (doubleValue) ; 

// Arrondir une valeur float 

int intResult = Math. round (f loatValue) ; 



II convient d'etre prudent si vous souhaitez convertir un 
nombre a virgule flottante en un entier. Si vous vous 
contentez de transtyper le nombre a virgule flottante en 
un int ou un long, la conversion en un int ou un long 
s'opere en tronquant simplement la portion decimale. 
Avec une valeur decimale comme 20.99999, vous obtien- 
drez done 20 apres le transtypage en une valeur int ou 
long. La methode appropriee pour realiser une conver- 
sion de nombre a virgule flottante en entier consiste a 
utiliser la methode Math . round () . L'exemple precedent 
montre comment arrondir une valeur double et une 
valeur float. Si vous passez une valeur double a la 
methode Math . round ( ) , le resultat retourne est un long. 

Si vous passez une valeur float a la methode Math 
. round (), le resultat retourne est un int. La methode 
Math, round () arrondit la valeur vers le haut si la partie 
decimale du nombre a virgule flottante est 0,5 ou plus et 
vers le bas pour les nombres dont la partie decimale est 
inferieure a 0,5. 
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Formater des nombres 



double value = 1623542.765; 
NumberFormat numberFormatter; 
String formattedValue; 

numberFormatter = NumberFormat .getNumber Inst ance( ) ; 
formattedValue = numberFormatter. format (value) ; 
System . out . format ( "%s%n " , formattedValue) ; 



Dans la plupart des applications, il est necessaire d'afficher 
des nombres. Le Java permet par chance le formatage des 
nombres, afin de leur donner l'apparence desiree lorsque 
vous souhaitez les afficher dans votre application. 

Cet exemple genere le nombre formate suivant en sortie : 

1 623 542,765 

Dans cet exemple, nous utilisons la classe NumberFormat 
pour formater une valeur double en une representation 
sous forme de chaine separee par des espaces. La classe 
NumberFormat se trouve dans le paquetage java.text. Elle 
est aussi tres utile pour le code que vous devez diffuser 
dans plusieurs pays. La classe NumberFormat supporte le 
formatage de nombres et de devises et sait egalement 
representer des nombres et des devises a l'aide de diffe- 
rents parametres regionaux. 

La classe NumberFormat peut aussi etre utilisee pour forma- 
ter des valeurs de pourcentage a afficher. Voici un exem- 
ple utilisant la classe NumberFormat pour formater un 
pourcentage a afficher : 

double percent = 0.80; 
NumberFormat percentFormatter; 
String f ormattedPercent ; 

percentFormatter = NumberFormat .getPercentInstance( ) ; 
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formattedPercent = percentFormatter. format (percent) ; 
System, out .format ( "%s%n 11 , formattedPercent) ; 

La sortie de ce code est la suivante : 
80% 

La classe NumberFormat possede egalement une methode 
parse ( ) qui peut etre utilisee pour parser des chaines con- 
tenant des nombres en un objet Number, a partir duquel 
peut s'obtenir un type numerique. 

Le JDK 1.5 a introduit la classe java.util. Formatter, un 
objet de formatage de portee generale permettant de for- 
mater un grand nombre de types. En plus des nombres, 
cette classe peut egalement formater des dates et des heu- 
res. Elle est tres bien documentee dans la documentation 
du JDK 1.5 a l'adresse suivante : http://java.sun.com/ 
j2se/1.5.0/ docs/ api/java/ util/Formatter.html. 

Le JDK 1.5 ajoute aussi deux methodes utilitaires a la 
classe java.io.PrintStream pour un formatage aise des 
objets OutputStream : format () et printf (). Toutes deux 
prennent une chaine de format et un nombre variable 
d'arguments Object en entree. Ces methodes sont tres 
proches des methodes de formatage des chaines classiques 
printf et scanf du C. Pour plus d'informations sur ces 
methodes, referez-vous a la documentation du JDK 1.5 a 
l'adresse http:/ /java.sun.com/j2se/1.5.0/ docs/ api/ 
java/io/PrintStream.html. 

Dans l'exemple suivant, nous allons voir comment for- 
mater des valeurs de devise a afficher avec la classe 
NumberFormat. 
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Formater des devises 



double currency = 567123678.99; 
NumberFormat currencyFormatter; 
String formattedCurrency; 

currencyFormatter = NumberFormat .getCurrency Instance ( ) ; 
formattedCurrency = currencyFormatter. format(currency) ; 
System . out . format ( "%s%n " , formattedCurrency) ; 



Comme pour l'exemple precedent concernant le forma- 
tage des nombres, nous utilisons ici la classe NumberFormat, 
mais afin de formater cette fois une valeur de devise. Nous 
utilisons la methode getCurrencylnstancef ) de la classe 
NumberFormat pour obtenir une instance de formatage de 
devise de la classe. Avec cette instance, nous pouvons pas- 
ser une valeur a virgule flottante et recuperer en retour 
une valeur de devise formatee. La sortie de cet exemple 
produit la chaine suivante : 

567 123 678,99 

En plus de placer des virgules aux emplacements appro- 
pries, le formateur de devises ajoute automatiquement le 
signe dollar apres la chaine (ou avant, selon les parametres 
regionaux) . 

Convertir un entier en nombre 
binaire, octal et hexadecimal 



int intValue = 24; 

String binaryStr = Integer. toBinaryString(intValue) ; 
String octalStr = Integer. toOctalString( intValue) ; 
String hexStr = Integer. toHexString(intValue) ; 
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La classe Integer permet aisement de convertir une valeur 
d'entier en un nonibre binaire, octal ou hexadecimal. 
Les methodes statiques concernees de la classe Integer 
sont les methodes toBinaryString( ), toOctalString ( ) et 
toHexString ( ) . Dans cet exemple, nous les utilisons cha- 
cune en passant dans chaque cas une valeur d'entier et 
en obtenant en retour un objet String contenant respec- 
tivement l'entier au format binaire, octal et hexadecimal. 

Generer des nombres aleatoires 



Random rn = new Random(); 
int value = rn.nextlnt ( ) ; 
double dvalue = rn. next Double () ; 



La classe Random du paquetage java.util peut etre utilisee 
pour generer des nombres aleatoires. Par defaut, elle uti- 
lise l'heure courante du jour comme valeur de graine 
pour son generateur de nombres aleatoires. Vous pouvez 
aussi definir vous-meme une valeur de graine en la passant 
comme parametre au constructeur de Random. La methode 
nextlnt ( ) produit un nombre aleatoire entier 32 bits. 

L'autre moyen de generer des nombres aleatoires consiste 
a utiliser la methode random () de la classe Math dans le 
paquetage java.lang. 

double value = Math . random( ) ; 

Cette methode retourne une valeur double avec un 
signe positif, superieure ou egale a 0,0 et inferieure a 1,0. 
Pour generer une valeur comprise dans un intervalle 
specifique, vous pouvez ajouter la limite inferieure au 
resultat de Math . random ( ) et multiplier par l'intervalle. 



76 CHAPITRE 7 Nombres 



Le code suivant produit ainsi un nombre aleatoire com- 
pris entre 5 et 20 : 

double value = (5+Math.random())*15; 

La classe Random et la methode random() de la classe Math 
fournissent en fait un nombre pseudo-aleatoire et non un 
veritable nombre aleatoire, car ce nombre est genere en 
utilisant une fomiule mathematique et une valeur de graine 
d'entree. Si Ton connait la valeur de graine et le meca- 
nisme interne de la classe Random, il est possible de predire 
la valeur obtenue. Ces classes ne constituent done genera- 
lenient pas une bonne solution pour les generateurs de 
nombres aleatoires a utiliser dans les applications forte- 
ment securisees. Dans la plupart des cas cependant, il s'agit 
de generateurs de nombres aleatoires parfaitement accep- 
tables. 

Calculer des fonctions 
trigonometriques 



// Calcul du cosinus 

double cosine = Math. cos (45 ) ; 

// Calcul du sinus 

double sine = Math. sin (45) ; 

// Calcul de la tangente 

double tangent = Math. tan (45) ; 



La classe Math du paquetage java.lang contient des 
methodes permettant de calculer aisement toutes les fonc- 
tions trigonometriques. Cet exemple montre comment il 
est possible de recuperer le cosinus, le sinus et la tangente 
d'un angle donne. La classe Math possede egalement des 
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methodes pour calculer l'arc cosinus, l'arc sinus et l'arc 
tangente ainsi que le sinus, le cosinus et la tangente hyper- 
boliques. Chacune de ces methodes prend un unique 
paranietre de type double en entree et retourne un resultat 
de type double. 

Calculer un logarithme 



double logValue = Math. log (125. 5) ; 



Cet exemple utilise la methode log ( ) de la classe 
java.lang.Math pour calculer le logarithme du paranietre 
passe. Nous passons une valeur de type double et la valeur 
de retour est egalement un double. La methode log( ) cal- 
cule le logarithme naturel de base e, ou e correspond a la 
valeur standard de 2,71828. 

Le JDK 1.5 a ajoute une nouvelle methode a la classe Math 
afin de calculer directement un algorithme de base 10 : 
log10(). Cette methode, analogue a log(), prend en 
entree un paranietre double et retourne un double. Elle 
peut aisement etre utilisee pour calculer un logarithme de 
base 10, comme ceci : 
double logBase10 = Math.log10(200) ; 
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Entree et sortie 



Dans la plupart des cas, l'entree et la sortie constituent le 
but ultime des applications. Les programmes seraient par- 
faitement inutiles s'ils ne pouvaient produire en sortie des 
resultats ni recuperer en entree des donnees a traiter four- 
nies par l'utilisateur ou l'ordinateur. Dans ce chapitre, 
nous presenterons quelques exemples de base pour les 
operations d'entree et de sortie. 

Les paquetages java.io et java.util abritent la plupart 
des classes utilisees dans ce chapitre pour les taches 
d'entree et de sortie. Nous verrons comment lire et ecrire 
des fichiers, travailler avec des archives ZIP, formater la 
sortie et travailler avec les flux de systeme d' exploitation 
standard. 

A mesure que vous lisez les exemples de ce chapitre, gar- 
dez a P esprit que bon nonibre des exercices peuvent lever 
des exceptions dans n'importe quel programme reel, telle 
l'exception java.io.IOException. Dans les exemples, 
nous n'inclurons pas le code de gestion des exceptions. 
Dans une application reelle, il est cependant imperatif 
qu'il soit present. 
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Lire du texte a partir 
d'une entree standard 



BufferedReader inStream = 

new BufferedReader (new InputStreamReader(System.in)); 
String inLine = ""; 

while ( !(inLine.equalsIgnoreCase("quit"))) { 
System. out. print ("prompt> "); 
inLine = inStream. readLine(); 

} 



Dans un programme de console, il est courant de lire 
1' entree standard qui provient le plus souvent de la ligne 
de commande. Cet exemple montre comment lire 
l'entree dans une variable String Java. Le Java contient 
trois flux connectes aux flux du systeme d'exploitation. II 
s'agit des flux standard d'entree, de sortie et d'erreur. lis 
sont respectivement definis en Java par System. in, Sys- 
tem, out et System. err. lis peuvent etre utilises pour lire 
ou ecrire vers et depuis l'entree et la sortie standard du 
systeme d'exploitation. 

Dans cet exemple, nous creons un BufferedReader arm de 
lire le flux System, in. Nous lisons avec ce lecteur les lignes 
de l'entree standard en poursuivant jusqu'a ce que l'utili- 
sateur tape le mot "quit". 

Ecrire vers une sortie standard 



System . out . print In ( " Hello , World ! " ) ; 



System. out est un PrintStream qui ecrit sa sortie vers la 
sortie standard (en general, la console). System. out est l'un 
des trois flux defini par le Java pour se connecter aux flux 
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de systeme d' exploitation standard. Les autres flux sont 
System. in et System . err, permettant de lire 1' entree stan- 
dard et d'ecrire dans le flux d'erreur standard. 

Le flux System. out est probablement le flux de systeme 
d' exploitation standard le plus frequemment utilise. II est 
mis a contribution par la quasi-totalite des programmeurs 
pour le debogage de leurs applications. Ce flux ecrit dans 
la console : il s'agit ainsi d'un outil pratique pour voir ce 
qui se passe a un point particulier de l'application. 

En general, les instructions System. out ne doivent cepen- 
dant pas etre conservees dans les programmes apres le 
debogage initial, car elles peuvent en affecter les perfor- 
mances. A long terme, il est preferable de recolter les 
informations de debogage dans votre application a l'aide 
d'un dispositif de journalisation comme celui que propo- 
sent j ava . util . logging ou le paquetage populaire Log4J 
d' Apache. 

Formater la sortie 



float hits=3; 

float ab=10; 

String formattedTxt = 

String. format( "Batting average: %.3f", hits/ab); 



Cet exemple utilise la methode format () pour formater 
une chaine de sortie qui imprime une moyenne a la batte 
en baseball sous sa forme classique a trois chiffres apres la 
virgule. La moyenne est definie en divisant le nombre de 
coups reussis par le nombre de "presences a la batte" 
(at-bats). Le specificateur de format %.3f demande au for- 
mateur d'imprimer la moyenne sous forme de nombre a 
virgule flottante avec trois chiffres apres la virgule. 
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Le JDK 1.5 a introduit la classe java.util. Formatter qui 
peut etre utilisee pour simplifier le formatage du texte. La 
classe Formatter opere a la maniere de la fonction printf 
du langage C et offre une prise en charge de la justifica- 
tion et de l'alignement pour la mise en page, des formats 
courants pour les donnees numeriques, les chaines et les 
dates et heures, ainsi qu'une sortie specifique en fonction 
des parametres regionaux. 

Voici un exemple d'utilisation directe de la classe Formatter : 

StringBuffer buffer = new StringBuffer( ) ; 

Formatter formatter = new Formatter(buffer, Locale. FRANCE) ; 

formatter. format ("Value of PI: %6.4f", Math. PI); 

System . out . println ( buffer . toSt ring ( ) ) ; 

Ce code produit la sortie suivante : 
Value of PI: 3,1416 

Dans cet exemple, nous creons une instance Formatter et 
l'utilisons pour formater la valeur mathematique standard 
du nombre pi. Celle-ci contient un nombre infini de chif- 
fres apres la virgule, mais il est generalement preferable 
d'en restreindre le nombre au moment de rimprimer. 

Dans cet exemple, nous avons utilise le specificateur de 
format %6.4f. La valeur 6 indique que la sortie pour ce 
nombre ne doit pas depasser 6 caracteres de longueur en 
comptant la virgule. La valeur 4 indique que la precision 
de la valeur decimale doit etre de 4 chiffres apres la 
virgule. La valeur imprimee atteint done 6 caracteres de 
longueur et possede 4 chiffres apres la virgule : 3, 1416. 

En plus d'utiliser directement la classe Formatter, vous 
pouvez utiliser les methodes format ( ) et printf ( ) des flux 
System. out et System. err. Voici par exemple comment 
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imprimer l'heure locale en utilisant la methode format () 
du flux System . out : 

System. out .format ( "Local time: %tT" , 
Calendar .get Instance () ) ; 

Cette methode imprime l'heure locale, comme ceci : 
Local time: 16:25:14 

La classe String contient egalement une methode statique 
format ( ) qui peut etre utilisee pour formater directement 
des chaines. Nous pouvons par exemple utiliser cette 
methode statique pour formater aisement une chaine de 
date comme ceci : 

Calendar c = new GregorianCalendar(1999, 
•Calendar. JANUARY, 6); 

String s = String. f ormat ( "Timmy 1 s Birthday: %1$tB %l$te, 
*»%1$tY", c); 

Ce code cree la valeur String formatee suivante : 
Timmy's Birthday: Janvier 6, 1999 

Toutes les methodes qui produisent une sortie formatee 
dont nous avons traite prennent une chaine de format et 
une liste d' arguments en parametres. La chaine de format 
est un objet String qui peut contenir du texte et un ou 
plusieurs specificateurs de format. 

Pour notre exemple de formatage precedent, la chaine de 
format serait "Timmy 1 s Birthday: %1$tm %1$te,%1$tY", les 
elements %1$tm, %1$te et $1$tY etant les specificateurs 
de format. 

Le reste de la chaine correspond a du texte statique. Ces 
specificateurs de format indiquent comment les argu- 
ments doivent etre traites et l'endroit de la chaine ou ils 
doivent etre places. 
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Pour faire reference a notre exemple de nouveau, la liste 
d'arguments correspond siniplement a l'objet Calendar c. 
Dans cet exemple, nous n'avons qu'un seul argument, 
mais la liste peut en contenir plusieurs. Tous les parame- 
tres passes aux methodes de forniatage apres la chaine de 
format sont consideres comme des arguments. 

Les specificateurs de format possedent le format suivant : 

%[index_argument$] [drapeaux] [largeur] [ .precision] 
^conversion 

index_argument fait reference a un argument dans la liste 
des arguments passee a la methode de forniatage. La liste 
est indexee en commencant a 1. Pour faire reference au 
premier argument, vous devez done utiliser 1$. 

L'element drapeaux designe un ensemble de caracteres qui 
modifient le format de sortie. L'ensemble de drapeaux 
valides depend du type de conversion. 

L'element largeur est un entier decimal positif indiquant 
le nombre minimal de caracteres a ecrire dans la sortie. 

L'element precision est un entier decimal positif norma- 
lement utilise pour restreindre le nombre de caracteres. Le 
comportement specifique depend du type de conversion. 

L'element conversion est un caractere indiquant comment 
F argument doit etre formate. L'ensemble des conversions 
valides pour un argument donne depend du type de don- 
nees de F argument. 

Tous les elements specificateurs sont facultatifs a l'excep- 
tion du caractere de conversion. 

Le Tableau 8.1 presente une liste des caracteres de conver- 
sion valides. Pour plus d'informations sur les conversions 
de date et d'heure, referez-vous au JavaDoc de la classe 
Formatter a l'adresse suivante : http://java.sun.com/ 
j2se/1.5.0/ docs/ api/. 



Formater la sortie 



Tableau 8.1 : Codes de format de Formatter 



Code Description 

b Si l'argument arg est null, le resultat est false. 

Si arg est un boolean ou un Boolean, le resultat 
est la chaine retournee par String. valueOf (). 
Sans cela, le resultat est true. 

h Si l'argument arg est null, le resultat est "null". 

Sans cela, le resultat est obtenu en invoquant 
Integer. toHexSt ring ( arg. hashCode( ) ). 

s Si l'argument arg est null, le resultat est "null". 

Si arg implemente Formattable, arg.formatTo 
est invoquee. Sans cela, le resultat est obtenu 
en invoquant arg.toString(). 

c Le resultat est un caractere Unicode. 

d Le resultat est formate sous forme d'entier decimal. 

o Le resultat est formate sous forme d'entier octal. 

x Le resultat est formate sous forme d'entier 

hexadecimal. 

f Le resultat est formate comme un nombre decimal. 

e Le resultat est formate sous forme de nombre 

decimal en notation scientifique informatisee. 

g Le resultat est formate en utilisant une notation 

scientifique informatisee ou le format decimal, 
selon la precision et la valeur apres l'arrondi. 

a Le resultat est formate sous forme de nombre 

hexadecimal a virgule flottante avec une mantisse 
et un exposant. 

t Prefixe pour les caracteres de conversion 

de date et d'heure. 

n Le resultat est le separateur de ligne specifique 

a la plate-forme. 

% Le resultat est un % litteral. 
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Pour obtenir une liste complete des codes de format 
disponibles, referez-vous a la documentation JavaDoc de 
la classe Formatter qui peut etre consultee a l'adresse 
http://java.sun.eom/j2se/l.5.0/docs/api/java/util/ 
Formatter.html. 
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r 

// Ouvrir un fichier en lecture 


1 


Buff eredReader is = 




new Buff eredReader (new FileReader( 


'file.txt")); 


// Ouvrir un fichier en ecriture 




BufferedWriter out = 




new BufferedWriter (new FileWriter( 1 


'afile.txt")); 



Cet exemple montre comment creer un Buff eredReader 
pour lire 1' entree d'un fichier specifie par un nom de 
fichier (ici, file.txt) et comment creer un BufferedWri- 
ter pour ecrire du texte vers un fichier de sortie specifie 
parson nom (afile.txt). 

II est tres facile d' ouvrir un fichier design e par son nom en 
Java. La plupart des classes de flux d' entree et de sortie ou 
de lecteur possedent une option permettant de specifier le 
fichier par nom dans le flux ou le constmcteur du lecteur. 
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Lire un fichier dans 
un tableau d'octets 



File file = new File(fileName) ; 
InputStream is = new FileInputStream(f ile) ; 
long length = file.length( ) ; 
byte[] bytes = new byte[ (int)length] ; 
int offset = 0; 
int numRead = 0; 
while ((offset < bytes. length) 
&& ((numRead=is.read(bytes, offset, 

bytes. length-offset) )>= 0)) { 

offset += numRead; 

} 

is.close(); 



Cet exemple lit le fichier specifie par fileName dans le 
tableau d'octets bytes. Notez que la methode file . length ( ) 
retourne la longueur du fichier en octets sous forme de 
valeur long, mais nous devons utiliser une valeur int pour 
initialiser le tableau d'octets. Nous transtypons done 
d'abord la valeur long en une valeur int. Dans un verita- 
ble programme, il conviendrait prealablement de s'assurer 
que la valeur de longueur tient effectivement dans un type 
int avant de la transtyper a l'aveuglette. Avec la methode 
read() du InputStream, nous continuons a lire les octets 
du fichier jusqu'a ce que le tableau d'octets soit rempli ou 
qu'il n'y ait plus d'octets a lire dans le fichier. 
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Lire des donnees binaires 



InputStream is = new FileInputStream(f ileName) ; 
int offset = 0; 

int bytesRead = is. read (bytes, offset, bytes. length-offset) ; 



La methode read() permet de lire des donnees binaires 
depuis un fichier dans un tableau d'octets. Dans cet exem- 
ple, nous lisons le flux d'entree is dans le tableau d'octets 
bytes. Le tableau bytes est ici suppose avoir ete prece- 
demment initialise sous forme de tableau d'octets et la 
variable fileName correspondre au nom d'un fichier 
valide. La variable offset pointe 1' emplacement du 
tableau d'octets a partir duquel Pecriture des donnees doit 
etre commencee. Elle est utile lorsque vous vous trouvez 
dans une boucle, que vous lisez les donnees d'un fichier 
et que vous ne souhaitez pas ecraser les donnees pre- 
cedemment stockees dans le tableau d'octets. A chaque 
passage dans la boucle, vous pouvez mettre a jour ce 
decalage, conime nous l'avons vu dans l'exemple prece- 
dent, "Lire un fichier dans un tableau d'octets". Voici la 
portion de code concernee : 

while ( (offset < bytes. length) 

&& ( (numRead=is.read(bytes, offset, 
bytes. length-offset) ) >= 0) ) { 

offset += numRead; 

} 

Dans cet exemple de code, nous ecrivons des donnees 
depuis le flux d'entee is dans le tableau bytes. Nous 
poursuivons la lecture depuis le fichier jusqu'a ce que 
nous ayons rempli le tableau bytes ou qu'il n'y ait plus de 
donnees a lire dans le fichier. 
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Atteindre une position 
dans un fichier 



File file = new File ("some-file, bin") ; 

RandomAccessFile raf = new RandomAccessFile(file, "rw"); 

raf . seek (file. length( ) ) ; 



La methode seek() de la classe RandomAccessFile permet 
d'atteindre n'importe quelle position desiree dans un 
fichier. Dans cet exemple, nous creons d'abord un objet 
File, qui est ensuite utilise pour creer une instance Rando- 
mAccessFile. Avec l'instance RandomAccessFile (raf), 
nous recherchons la fin du fichier en passant la valeur 
file . length ( ) en parametre a la methode seek( ) . 

Apres avoir utilise la methode seek() pour trouver la 
position desiree dans le fichier, nous pouvons ensuite uti- 
liser les methodes read() ou write () de la classe RandomAc- 
cessFile pour lire ou ecrire des donnees a partir de cette 
position exacte. 

Lire une archive JAR ou ZIP 



// Lire un fichier ZIP 
ZipFile file = new ZipFile(filename) ; 
Enumeration entries = file.entries(); 
while (entries. hasMoreElements()) { 

ZipEntry entry = (ZipEntry ) entries. nextElementf) ; 

if (entry. isDirectoryO) { 
// Traiter le repertoire 

} 

else { 
// Traiter le fichier 

} 

} 

file.close() ; 
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Le Java offre un support integre pour la lecture et l'ecri- 
ture de fichiers d'archive ZIP. Les fichiers ZAR n'etant 
autres que des fichiers ZIP possedant un contenu precis, 
les classes et les methodes des fichiers ZIP peuvent ega- 
lement etre utilisees pour les lire. Les classes ZIP sont 
contenues dans le paquetage java.util.zip qui fait partie 
du JDK standard. 

Dans cet exemple, nous creons d'abord un objet ZipFile 
en passant le nom de fichier d'un fichier ZIP existant au 
constructeur de la classe ZipFile. Nous obtenons ensuite 
l'ensemble des entrees du fichier ZIP dans un type d'enu- 
meration en appelant la methode entries () de l'objet 
ZipFile. Une fois en possession des entrees de fichier ZIP 
sous forme d'enumeration, nous pouvons parcourir au 
pas a pas les entrees et instancier un objet ZipEntry pour 
chaque entree. Avec l'objet ZipEntry, nous pouvons 
determiner si l'entree particuliere qui est traitee est un 
repertoire ou un fichier et la traiter en fonction. 



Creer une archive ZIP 



// Ecrire un fichier ZIP 
ZipOutputStream out = 

*»new ZipOutputStream (new FileoutputStream(zipFileName) ) ; 
FilelnputStream in = new FileInputStream(fileToZip1 ) ; 
out .putNextEntry(new ZipEntry (f ileToZipl )) ; 
int len; 

byte[] buf = new byte[1024]; 
while ((len = in . read (buf ) ) > 0) { 
out.write(buf ,0,len) ; 

} 

out .closeEntry() ; 
in.closef) ; 
out. close () ; 
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Dans l'exemple precedent, nous avons vu comment lire 
dans un fichier ZIP. Cette fois, nous creons un fichier 
ZIP. Pour cela, nous commencons par construire un 
ZipOutputStream en passant a son constructeur un objet 
FileOutputStream pointant vers le fichier que nous sou- 
haitons compresser sous forme de fichier ZIP. Ensuite, 
nous creons un FilelnputStream pour le fichier que nous 
souhaitons ajouter a notre archive ZIP. Nous utilisons la 
methode putNextEntry( ) du ZipOutputStream pour ajou- 
ter le fichier a l'archive. 

La methode putNextEntry ( ) prend un objet ZipEntry en 
entree : nous devons done construire le ZipEntry a partir 
du nom du fichier que nous ajoutons a notre archive. 
Dans une boucle while, nous lisons ensuite notre fichier 
en utilisant le FilelnputStream et l'ecrivons dans le 
ZipOutputStream. Une fois cela fait, nous fermons l'entree 
en utilisant la methode closeEntry() du ZipOutputStream, 
puis fermons chacun de nos flux ouverts. 

Dans cet exemple, nous n'avons ajoute qu'un seul fichier 
a notre archive ZIP, mais ce code peut aisement etre 
etendu afm d'ajouter autant de fichiers que necessaire a 
l'archive. La classe ZipOutputStream accepte aussi bien les 
entrees compressees que les entrees non compressees. 
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Travailler avec 
des repertoires 
et des fichiers 



L'une des taches courantes dans la plupart des applications 
Java consiste a travailler avec le systeme de fichiers et 
notamment ses repertoires et ses fichiers. Ce chapitre pre- 
sente un certain nombre d'exemples destines a vous aider 
a travailler avec des fichiers et des repertoires en Java. 

La principale classe que nous utiliserons pour ces exem- 
ples est la classe j ava . io . File. Elle permet de lister, creer, 
renommer et supprimer des fichiers, mais encore de tra- 
vailler avec des repertoires. 

Bon nombre des exemples de ce chapitre peuvent lever 
une exception SecurityException. En Java, le systeme de 
fichiers est protege par le gestionnaire de securite. Pour 
certaines applications, il peut falloir en utiliser une imple- 
mentation personnalisee. Parmi les applications Java, les 
applets sont les plus restreintes en ce qui concerne Faeces 
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aux fichiers et aux repertoires sur l'ordinateur local de 
Putilisateur, En tirant parti du gestionnaire de securite et 
du framework de strategic de securite lie vous pouvez 
controler precisement l'acces aux fichiers et aux repertoi- 
res. Pour plus d'informations sur les options de securite 
disponibles en Java, consultez la documentation de secu- 
rite disponible (en anglais) sur le site Web Java officiel 
a l'adresse http://java.sun.com/javase/technologies/ 
security .jsp. 

Pour plus d'informations sur le gestionnaire de securite, 
consultez le didacticiel suivant (en anglais) propose par Sun : 
http:/ /java.sun.com/ docs/books/ tutorial/ essential/ 
system/ securityIntro.html. 

Creer un fichier 



File f = new File ( "myfile.txt") ; 
boolean result = f .createNewFile() ; 



Cet exemple utilise la methode createNewFile( ) pour 
creer un nouveau fichier portant le nom specifie en para- 
metre (ici, myfile.txt) en construisant l'objet File. La 
methode createNewFile ( ) retourne la valeur booleenne 
true si le fichier a bien ete cree et false si le nom de 
fichier specifie existe deja. 

La classe File propose une autre methode statique pour 
creer un fichier temporaire : createTempFile ( ) . L'exem- 
ple suivant montre comment Futiliser pour creer un 
fichier temporaire : 

File tmp = File . createTempFile ( "temp" , "txt", "/temp"); 



Renommer un fichier ou un repertoire 

Les parametres que nous passons a la methode createTemp- 
File ( ) sont le prefixe du fichier temporaire, son suffixe et 
son repertoire. II existe aussi une autre version de cette 
methode qui ne prend que deux parametres et utilise le 
repertoire temporaire par defaut. Le fichier specifie doit 
deja exister pour que l'une ou l'autre forme des methodes 
createTempFile ( ) puisse fonctionner. 

Si vous utilisez des fichiers temporaires, la methode delete- 
OnExit() de la classe File peut aussi vous interesser. Elle 
doit etre appelee sur un objet File qui represente un 
fichier temporaire. L'appel de la methode deleteOnExit ( ) 
requiert que le fichier soit automatiquement supprime 
lorsque la machine virtuelle Java se ferme. 

Renommer un fichier 
ou un repertoire 



File f = new File ( "myfile.txt") ; 

File newFile = new File( "newname.txt") ; 

boolean result = f .renameTo(newFile) ; 



Dans cet exemple, nous renommons le fichier myfile.txt 
en l'appelant newname.txt. Pour cela, nous devons creer 
deux objets File. Le premier est construit avec le nom 
courant du fichier. Ensuite, nous creons un nouvel objet 
File en utilisant le nom de remplacement que nous sou- 
haitons donner au fichier. Nous appelons la methode 
renameTo() de l'objet File d'origine et lui passons l'objet 
File specifiant le nouveau nom de fichier. La methode 
renameTo() retourne la valeur booleenne true si l'opera- 
tion de modification du nom reussit et false sinon, quelle 
que soit la raison. 
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Cette technique peut egalement etre utilisee pour renom- 
mer un repertoire. Le code est alors exactement le meme, 
a la difference que nous passons cette fois les noms de 
repertoire aux constmcteurs de l'objet File au lieu des 
noms de fichier. Voici comment proceder : 

File f = new File ( "directoryA" ) ; 

File newDirectory = new File ( "newDirectory" ) ; 

boolean result = f . renameTo(newDirectory) ; 

Rappelez-vous que le nouveau nom de fichier ou de 
repertoire doit etre specifie dans un objet File passe a la 
methode renameTo(). L'une des erreurs courantes consiste 
a tenter de passer un objet String contenant le nouveau 
nom de fichier ou de repertoire a la methode renameTo( ) . 
Une erreur de compilation est generee si un objet String 
est passe a la methode renameTo( ). 

Supprimer un fichier 
ou un repertoire 



File f = new File ( "somefile.txt") ; 
boolean result = f.delete(); 



La classe File permet aisement de supprimer un fichier. 
Dans cet exemple, nous creons d'abord un objet File en 
specifiant le nom du fichier a supprimer. Ensuite, nous 
appelons la methode delete () de l'objet File. Elle 
retourne la valeur booleenne true si le fichier a bien ete 
supprime et false sinon. 

La methode delete ( ) peut aussi etre utilisee pour suppri- 
mer un repertoire. Dans ce cas, vous devez creer l'objet 
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File en specifiant le nom du repertoire au lieu d'un nom 
de fichier, comme ceci : 
File directory = new File ( "files/images" ) ; 
directory. delete( ) ; 

Le repertoire n'est supprime que s'il est vide. S'il ne Test 
pas, la methode delete () retourne la valeur booleenne 
false. Si le fichier ou le repertoire que vous essayez de 
supprimer n'existe pas, delete ( ) retourne aussi false, sans 
lever d'exception. 

La classe File propose une autre methode utile liee a la 
suppression des fichiers et des repertoires : deleteOnExit ( ) . 
Lorsqu'elle est appelee, le fichier ou le repertoire repre- 
sente par l'objet File sont automatiquement supprimes 
lorsque la machine virtuelle Java se ferine. 

Modifier des attributs de fichier 



File f = new File ( "somefile.txt" ) ; 
boolean result = f .setReadOnly() ; 
long time = (new Date() ) .getTime() ; 
result = f .setLastModified(time) ; 



L'objet File permet aisement de modifier l'horodatage de 
derniere modification et l'etat de lecture/ecriture d'un 
fichier. Pour realiser ces taches, vous devez utiliser les 
methodes setReadOnly( ) et setLastModif ied ( ) de la classe 
File. La methode setReadOnly ( ) positionne en lecture 
seule le fichier sur lequel elle est appelee. La methode set- 
LastModif ied ( ) prend un unique parametre en entree 
specifiant une date en milhsecondes et positionne l'horo- 
datage de derniere modification du fichier a cette date. 
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La valeur temporelle passee est mesuree en millisecon- 
des ecoulees depuis l'epoque UNIX (l el janvier 1970, 
00 h 00 m 00 s, GMT). Ces deux methodes retournent la 
valeur booleenne true uniquement si l'operation reussit. 
Si l'operation echoue, elles retournent false. 

Obtenir la taille d'un fichier 



File file = new Filef'infilename"); 
long length = file. length () ; 



Dans cet exemple, nous retrouvons la taille d'un fichier 
en utilisant la methode length() de l'objet File. Cette 
methode retourne la taille du fichier en octets. Si le fichier 
n'existe pas, elle retourne 0. 

Cette methode est souvent utile avant de lire un fichier 
sous forme de tableau d'octets. Grace a la methode 
length (), vous pouvez determiner la longueur du fichier 
afin de connaitre la taille requise pour que le tableau 
d'octets contienne la totalite du fichier. Le code suivant 
est ainsi souvent utilise pour lire un fichier dans un tableau 
d'octets : 

File myFile = new File( "myfile.bin" ) ; 
InputStream is = new FilelnputStream(myFile) ; 
// Obtenir la taille du fichier 
long length = myFile. length( ) ; 
if (length > Integer. MAX_VALUE) { 
// Le fichier est trop grand 

} 

byte[] bytes = new byte[ (int)length] ; 
int offset = 0; 
int numRead = 0; 
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while (offset < bytes. length 

&& (numRead=is. read(bytes, offset, 
kbytes. lengthof f set) ) >= 0) { 

offset += numRead; 

} 

is.close() ; 

Determiner si un fichier 
ou un repertoire existe 



boolean exists = (new File( "filename")) .exists(); 
if (exists) { 

// Le fichier ou le repertoire existe 

} 

else { 

// Le fichier ou le repertoire n' existe pas 

} 



Cet exemple utilise la methode exists)) de l'objet File 
pour determiner si le fichier ou le repertoire represente 
par cet objet existe. Elle retourne true si le fichier ou le 
repertoire existe et false sinon. 

Deplacer un fichier 
ou un repertoire 



File file = new File( "filename "); 
File dir = new File( "directoryname "); 
boolean success = 

*»file.renameTo(new File(dir, f ile.getName( ) ) ) ; 
if (! success) { 

1 1 Le fichier n'a pas pu etre deplace 

} 
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La methode renameTo() de la classe File permet de 
deplacer un fichier ou un repertoire dans un autre reper- 
toire. Dans cet exemple, nous creons un objet File afin de 
representer le fichier ou le repertoire a deplacer. Nous 
creons un autre objet File representant le repertoire de 
destination dans lequel nous souhaitons deplacer le fichier 
ou le repertoire, puis appelons la methode renameTo( ) du 
fichier deplace en lui passant un unique parametre d'objet 
File. L'objet File passe en parametre est construit en uti- 
lisant le repertoire de destination et le nom de fichier 
d'origine. Si 1' operation de de-placement reussit, la 
methode renameTo() retourne la valeur booleenne true. 
En cas d'echec, elle retourne false. 

Lorsque vous utilisez la methode renameTo( ), gardez a 
l'esprit que bien des aspects de ce comportement 
dependent de la plate-forme d'execution. Certains sont 
signales dans le JavaDoc pour cette methode, et notam- 
ment les suivants : 

■ L'operation renameTo peut ne pas etre capable de 
deplacer un fichier d'un systeme de fichiers a un autre. 

■ L'operation renameTo peut ne pas etre atomique. 
Autrement dit, Fimplernentation de l'operation rena- 
meTo peut se decomposer en plusieurs etapes au niveau 
du systeme d' exploitation : cette particularite peut 
poser probleme en cas d'incident, comme lors d'une 
coupure de courant survenant entre les etapes. 

■ L'operation renameTo peut echouer si un fichier posse- 
dant le nom du chemin abstrait de destination existe 
deja. 

Lorsque vous utilisez cette methode, verifiez toujours la 
valeur de retour afin de vous assurer que l'operation a 
reussi. 
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Obtenir un chemin de nom 
de fichier absolu a partir 
d'un chemin relatif 



File file = new File( "somefile.txt "); 
File absPath = file.getAbsoluteFile() ; 



Cet exemple retrouve le chemin absolu d'un fichier dont 
le chemin relatif est specifie. Le chemin absolu definit le 
chemin complet du fichier en commencant a partir du 
repertoire racine du systeme de fichiers, comme ceci : 
c: \project\book\somefile.txt. 

Le nom de fichier relatif specifie le nom et le chemin du 
fichier par rapport au repertoire courant, comme some- 
file.txt si le repertoire courant est c:\project\book. 
Dans bien des cas, le nom de chemin relatif n'est constitue 
que du nom de fichier. La methode getAbsoluteFile( ) de 
la classe File retourne une objet File representant le nom 
de fichier absolu pour le fichier represente par l'objet File 
sur lequel elle est appelee. 

Une autre methode similaire, getAbsolutePath ( ), retourne 
le chemin absolu sous forme de String et non d'objet File. 
Le code suivant presente cette methode : 

File file = new File( "filename.txt "); 
String absPath = file .getAbsolutePath () ; 

Dans cet exemple, absPath contient la chaine "c : \proj ect \ 
book\somefile.txt". 
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Determiner si un chemin de nom 
de fichier correspond a un fichier 
ou a un repertoire 



File testPath = new File( "directoryName "); 
boolean isDir = testPath. isDirectory() ; 
if (isDir) { 

// testPath est un repertoire 

} 

else { 

// testPath est un fichier 

} 



Cet exemple determine si l'objet File designe represente 
un fichier ou un repertoire. La methode isDirectory ( ) 
de la classe File retourne true si l'objet File sur lequel 
elle est appelee represente un repertoire et false s'il 
represente un fichier. Elle est utile lorsque vous souhai- 
tez parcourir 1'ensemble des fichiers et sous-repertoires 
d'un repertoire donne. Par exemple, vous pourriez sou- 
haiter ecrire une methode qui liste tous les fichiers d'un 
repertoire et parcoure de maniere recurrente chacun de 
ses sous-repertoires. 

La methode isDirectory( ) peut etre utilisee lorsque vous 
parcourez la liste des elements contenus dans chaque 
repertoire afin de determiner s'il s'agit d'un fichier ou 
d'un repertoire. 

Voici un exemple de ce type de methode qui utilise la 
methode isDirectory ( ) : 

static void listAHFiles (File dir) { 
String[] files = dir.list(); 
for (int i = 0; i < files . length ; i++) { 
File f = new File(dir, files[i]); 
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if (f .isDirectoryO) { 
listAHFiles(f); 

} 

else { 

System . out . println (f . getAbsolutePath ( ) ) ; 

} 

} 

} 

Si vous appelez cette methode et lui passez un objet File 
representant un repertoire, elle imprime les chemins com- 
plets de tous les fichiers contenus dans le repertoire et dans 
1' ensemble de ses sous-repertoires. 

La classe File contient aussi une methode isFile() qui 
retourne true si l'objet File sur lequel elle est appelee 
represente un fichier et false sinon. 

Lister un repertoire 



File directory = new File( "users/tim") ; 
String[] result = directory. list() ; 



La classe File peut aussi etre utilisee pour lister le contenu 
d'un repertoire. Cet exemple utilise la methode list ( ) de 
la classe File pour obtenir un tableau d'objets String 
contenant tous les fichiers et sous-repertoires contenus 
dans le repertoire specifie par l'objet File. Si le repertoire 
n'existe pas, la methode retourne null. Les chaines 
retournees sont des noms de fichiers et des nonis de reper- 
toire simples et non des chemins complets. L'ordre des 
resultats n'est pas garanti. 
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La methode list ( ) possede une autre implementation qui 
prend un parametre j ava . io . FilenameFilter et permet de 
filtrer les fichiers et repertoires retournes dans les resultats 
de la methode. En voici un exemple : 

File directory = new File( "users/tim" ) ; 
FilenameFilter fileFilter = new HTMLFileFilter( ) ; 
String[] result = directory . list (fileFilter) ; 

Voici maintenant l'implementation correspondante de la 
classe HTMLFileFilter : 

class HTMLFileFilter extends FilenameFilter { 
public boolean accept(File f) { 
return f . isDirectory ( ) || f.getName() 
. toLowerCase( ) . endsWith ( " . html" ) ) ; 

} 

public String getDescription ( ) } 
return "/html files" ; 

} 

FilenameFilter est une interface definissant une methode 
nominee accept (). Celle-ci prend deux parametres : un 
objet File et un objet String. L'objet File specifie le 
repertoire dans lequel le fichier a ete trouve et l'objet 
String specifie le nom du fichier. La methode accept () 
retoume true si le fichier doit etre inclus dans la liste et 
false sinon. Dans cet exemple, nous avons cree un filtre 
qui amene la methode list ( ) a n'inclure que les fichiers 
qui se terminent par l'extension . html. 

Si le filtre passe est null, la methode se comporte comme 
la precedent* methode list ( ) sans parametre. 

En plus des methodes list ( ) , la classe File propose 
deux versions d'une methode appelee listFiles(). 
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listFiles() retourne un tableau d'objets File au lieu 
d'un tableau de chaines. L'exeniple utilise sa variante sans 
paranietre : 

File directory = new File ( " users/tim" ) ; 
File[] result = directory. listFiles( ) ; 

Les objets File resultants contiennent des cheniins relatifs 
ou absolus selon l'objet File depuis lequel la methode 
listFiles() a ete appelee. Si l'objet File de repertoire 
dans cet exemple contient un chemin absolu, le resultat 
contient des chemins absolus. Si l'objet File de repertoire 
contient un chemin relatif, les resultats sont des chemins 
relatifs. 

L'autre version de listFiles( ) prend un paranietre File- 
Filter, de maniere analogue a 1' exemple presente pour la 
methode list ( ) . En voici un exemple : 

File directory = new File ( "users/tim" ) ; 
FileFilter fileFilter = new HTMLFileFilter( ) ; 
String[] result = directory . listFiles (fileFilter) ; 

Voici maintenant l'implementation correspondante de la 
classe HTMLFileFilter : 

class HTMLFileFilter extends FileFilter { 
public boolean accept(File f) { 
return f . isDirectory ( ) | | 
f .get Name ( ) . toLowerCase( ) . endsWith ( " . html" ) ; 

} 

public String getDescription ( ) { 
return " . html files" ; 

} 

} 
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FileFilter est une interface definissant deux methodes, 
accept () et getDescription ( ) . Ala difference de la 
methode accept () de FilenameFilter, la methode 
accept () de FileFilter ne prend qu'un parametre, un 
objet File. L'objet File specifie un fichier ou un reper- 
toire. La methode accept () retourne true si le fichier 
ou le repertoire doivent etre inclus dans la liste et false 
sinon. Dans cet exemple, nous avons cree un filtre qui 
aniene la methode list() a n'inclure que les repertoires 
ou les fichiers qui se terminent par l'extension . html. 

Creer un nouveau repertoire 



boolean success = (new File("users/tim")).mkdir(); 



Cet exemple utilise la methode mkdir() de la classe File 
pour creer un nouveau repertoire. mkdir( ) retourne true 
si le repertoire a pu etre cree et false sinon. Elle ne cree 
de repertoire que si tous les repertoires parents specifies 
existent deja. Ici, il est done necessaire que le repertoire 
users existe deja pour que mkdir() parvienne a creer le 
repertoire users/tim. 

La methode mkdirs() de la classe File est une methode 
similaire qui permet de creer un arbre de repertoires com- 
plet en generant tous les repertoires parents s'ils n'existent 
pas. En voici un exemple : 

boolean success = (new File( "/users/tim/Web" ) ) .mkdirs( ); 

A l'execution de cette instruction, la methode mkdirs() 
creera tous les repertoires (users, tim, Web) qui n'existent 
pas. 
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Clients reseau 



La plupart des applications ecrites aujourd'hui requierent 
differents types de fonctionnalites reseau. Les applications 
Java entierement autonomes se font de plus en plus rares. 
Ce chapitre sur les clients reseau a done toutes les chances 
d'etre utile a la plupart des developpeurs Java qui concoi- 
vent des applications aujourd'hui. 

Les programmes reseau impliquent une communication 
entre un client et un serveur. En general, le client est 
l'application qui transmet une demande de contenu ou de 
services et le serveur une application reseau qui sert ce 
contenu et ces services a de nombreux clients. Dans ce 
chapitre, nous nous concentrerons specifiquenient sur le 
client. Le Chapitre 11, "Serveurs reseau" traite des exem- 
ples lies au serveur. 

A l'exception d'un exemple concernant la lecture d'une 
page Web via HTTP, les exemples de ce chapitre operent 
tous au niveau de la programmation avec les sockets. Les 
sockets sont une implementation reseau de bas niveau. 
Dans la plupart des cas, vous chercherez a utiliser un pro- 
tocole situe au niveau juste superieur a celui de la couche 
des sockets, comme le HTTP, le SMTP ou le POP. 
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D'autres API Java ou tierces permettent de travailler avec 
ces protocoles reseau de plus haut niveau. Le paquetage 
java.net fournit les fonctionnalites de communication 
reseau cote client que nous utiliserons dans ce chapitre. 

La plate-forme J2EE (que nous n'abordons pas dans ce 
livre) propose de nombreux services reseau supplemen- 
taires dont un support complet du developpement Web 
Java cote serveur. Parmi les technologies reseau incluses 
dans la plate-forme J2EE, on peut citer les servlets, les EJB 
et leJMS. 

Contacter un serveur 



String serverName = "www.timothyfisher.com"; 
Socket sock = new Socket(serverName, 88); 



Dans cet exemple, nous nous connectons a un serveur 
via TCP/IP a l'aide de la classe Java Socket. Lors de la 
construction de l'mstance sock, une connexion de socket 
est operee au serveur specifie par serverName — ici, 
www.timothyfisher.com, sur le port 80. 

A chaque fois qu'un Socket est cree, vous devez veiller a 
fermer le socket lorsque vous avez termine en appelant la 
methode close () sur l'instance Socket avec laquelle vous 
travaillez. 

Le Java prend en charge d'autres methodes de connexion 
au serveur dont nous ne traiterons pas en detail ici. Par 
exemple, vous pouvez utiliser la classe URL pour ouvrir 
une URL et la lire. Pour plus de details sur l'titihsation de 
la classe URL, consultez 1 ! exemple "Lire une page Web via 
HTTP" de ce chapitre. 
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Retrouver des adresses IP 
et des noms de domaine 



// Trouver l'adresse IP d'un domaine 
String hostName = www.timothyfisher.com"; 
String ip = 

inetAddress . getByName(hostName) . getHostAddress ( ) ; 
// Trouver le nom de domaine de l'adresse IP 
String ipAddress = "66.43.127.5"; 
String hostName = 

InetAddres . get ByName ( ipAddress ) . get Host Name ( ) ; 



Dans cet exemple, nous recuperons le nom d'hote corres- 
pondent a une adresse IP connue, puis nous recuperons 
l'adresse IP correspondant a un nom d'hote distant. Pour 
ces deux taches, nous faisons appel a la classe InetAddress. 

Nous utilisons la methode statique getByName() de la 
classe InetAddress pour creer une instance InetAddress. 
Nous pouvons passer une adresse IP ou un nom d'hote a 
la methode getByName() pour creer l'instance InetAddress. 

Une fois l'instance InetAddress creee, nous pouvons 
appeler la methode getHostAddress ( ) pour retourner 
l'adresse IP sous forme de String. Si nous connaissons 
deja l'adresse IP, nous pouvons appeler la methode 
getHostName( ) pour retourner le nom d'hote sous forme de 
String. Si le nom d'hote ne peut pas etre resolu, la 
methode getHostName ( ) retourne l'adresse IP. 
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Gerer les erreurs reseau 



try { 

// Connexion a l'hote reseau 
// Realisation des E/S reseau 
} 

catch (UnknownHostException ex) { 
System. err .print In ( "Unknown host . " ) ; 

} 

catch (NoRouteToHostException ex) { 

System. err .print In ( "Unreachable host . ") ; 

} 

catch (ConnectException ex) { 
System . err . println ( " Connect refused . " ) ; 

} 

catch (lOException ex) { 
System . err . println ( ex . getMessage ( ) ) ; 

} 



Cet exemple presente les exceptions que vous devez ten- 
ter de capturer lorsque vous realisez des operations reseau. 
La premiere exception que nous essayons de capturer est 
Fexception UnknownHostException. II s'agit d'une sous-classe 
d'lOException. Elle est levee afin d'indiquer que l'adresse 
IP d'un hote ne peut etre deterniinee. 

NoRouteToHostException et ConnectException sont des 
sous-classes de SocketException. NoRouteToHostException 

signale qu'une erreur s'est produite lors de la tentative de 
connexion a un socket a une adresse et un port distants. 
En general, l'hote distant ne peut pas etre atteint en raison 
d'un probleme lie a un pare-feu ou un routeur interpose. 

L'exception ConnectException est levee si une connexion 
a l'hote distant est refusee. lOException est une exception 
de portee plus generale qui peut egalement etre levee a 
partir d'appels reseau. 
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Les exemples de ce chapitre et du suivant n'incluent pas 
de mecanisnie de gestion des erreurs. II convient cepen- 
dant de capturer ces exceptions dans vos applications Java 
qui utilisent des fonctionnalites reseau. 

Lire du texte 



BufferedReader in = new BufferedReader 

(new InputStreamReader ( socket . getlnputSt ream ( ) ) ) ; 
String text = in.readLine(); 



Cet exemple suppose que vous avez precedemment cree 
un socket au serveur a partir duquel vous souhaitez lire du 
texte. Pour plus d'informations sur la creation d'une ins- 
tance de socket, consultez l'exemple "Contacter un ser- 
veur" de ce chapitre. Une fois l'instance socket obtenue, 
nous appelons la methode getlnputstream( ) pour obtenir 
une reference au flux d'entree du socket. Avec cette refe- 
rence, nous creons un InputStreamReader et l'utilisons pour 
instancier un BufferedReader. Nous lisons enfin le texte sur 
le reseau avec la methode readLine( ) du BufferedReader. 

Cet usage du BufferedReader permet d'effectuer une lec- 
ture efficace des caracteres, des tableaux et des lignes. Si vous 
cherchez simplement a lire une tres petite quantite de don- 
nees, vous pouvez cependant aussi proceder directement 
depuis InputStreamReader, sans utiliser de BufferedReader. 

Voici comment lire des donnees dans un tableau de carac- 
teres en n'utilisant qu'un InputStreamReader : 

InputStreamReader in = 

»»new InputSt reamReader( socket .getlnputSt ream () ) ) ; 

String text = in . read (charArray , offset, length); 
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Dans cet exemple, les donnees sont lues depuis le flux 
d'entree dans le tableau de caracteres specifie par charArray. 
Les caracteres sont places dans le tableau en commencant 
a une position specifiee par le paranietre de decalage offset, 
et le nombre maximal de caracteres lus est specifie par le 
parametre length. 

Ecrire du texte 



PrintWriter out = 

»»new PrintWriter(socket.getOutputStream() , true); 
out. print (msg) ; 
out. f lush () ; 



Cet exemple requiert que vous ayez precedemment cree 
un socket au serveur a destination duquel vous souhaitez 
ecrire du texte. Pour plus de details sur la creation de 
l'instance de socket, consultez 1' exemple "Contacter un 
serveur" de ce chapitre. Une fois l'instance de socket 
obtenue, nous appelons la methode getOutputStream( ) 
pour obtenir une reference au flux de sortie du socket. 
Lorsque la reference est acquise, nous instancions un 
PrintWriter afin d'ecrire du texte sur le reseau vers le ser- 
veur avec lequel nous sommes connectes. Le second para- 
metre que nous passons au constructeur PrintWriter dans 
cet exemple definit 1' option de purge automatique. La 
valeur true amene les methodes println(), printf() et 
format () a vider automatiquement le tampon de sortie. 
Dans notre exemple, nous utilisons la methode print(). 
Nous devons done la faire suivre par un appel a la 
methode flush () pour forcer l'envoi des donnees sur le 
reseau. 
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Lire des donnees binaires 



DatalnputStream in = 

new DatalnputStream (socket . get InputStream ( ) ) ; 
in . readllnsignedByte ( ) ; 



Cet exemple montre comment lire des donnees binaires 
sur un reseau. II requiert que vous ayez precedemment 
cree un socket au serveur a partir duquel vous souhaitez 
lire du texte. Pour plus de details sur la creation de l'ins- 
tance de socket, consultez 1' exemple "Contacter un ser- 
veur" de ce chapitre. 

Dans cet exemple, nous appelons la methode getlnput- 
Stream( ) de l'instance de socket afni d'obtenir une reference 
au flux d'entree du socket. En passant le flux d'entree en 
parametre, nous instancions un DatalnputStream, que 
nous pouvons utiliser pour lire des donnees binaires sur le 
reseau. Nous utilisons la methode readUnsignedByte( ) 
pour lire un unique octet non signe sur le reseau. 

Si le volume de donnees que vous lisez est important, il 
est preferable d'encapsuler le flux d'entree du socket dans 
une instance Buff eredlnputStream, comme ceci : 

DatalnputStream in = new DataInputStream(new 
»»BufferedInputStream(socket .getlnputstream( ) ) ) ; 

Ici, au lieu de passer directement le flux d'entree du socket 
au constructeur DatalnputStream, nous creons d'abord 
une instance Buff eredlnputStream et la passons au cons- 
tructeur DatalnputStream. 

Dans cet exemple, nous avons utilise la methode read- 
UnsignedByte( ), mais DatalnputStream possede bien d'autres 
methodes pour lire des donnees dans n'importe quel 
type de donnees Java primitif, dont les suivantes : read( ), 
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readBoolean ( ), readByte(), readChar(), readDouble( ), read- 
Float (), readlnt(), readLong(), readShort(), readUnsigned- 
Byte() et readUnsignedShort ( ). Consultez leJavaDoc pour 
plus de details sur l'utilisation de ces methodes et d'autres 
methodes de la classe DatalnputStream : http://java.sun 
.com/j2se/1.5.0/docs/api/java/io/DataInputStream 
.html. 

Ecrire des donnees binaires 



DataOutputStream out = 

»»new DataOutputStream ( socket . getOutputStream ( ) ) ; 
out.write(byteArray, 0, 10); 



Dans Pexemple "Ecrire du texte" vu precedemment, nous 
avons montre comment ecrire des donnees texte sur un 
reseau. Cet exemple montre comment ecrire des donnees 
binaires sur le reseau. II requiert que vous ayez precedem- 
ment cree un socket au serveur a destination duquel vous 
souhaitez ecrire du texte. Pour plus de details sur la crea- 
tion de l'instance de socket, consultez 1' exemple "Contac- 
ter un serveur" de ce chapitre. 

Dans cet exemple, nous appelons la methode getOutput- 
Stream() de l'instance de socket pour obtenir une refe- 
rence au flux de sortie du socket. Nous instancions 
ensuite un DataOutputStream, que nous pouvons utiliser 
pour ecrire des donnees binaires sur le reseau. Nous utili- 
sons la methode write () pour ecrire un tableau d'octets 
sur le reseau. La methode write ( ) prend trois parametres. 
Le premier est un byte[ ] servant a recuperer les octets a 
partir desquels ecrire. Le second definit un decalage dans 
le tableau d'octets servant a determiner la position a partir 
de laquelle Fecriture doit etre effectuee. Le troisieme 
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specitie le nombre d'octets a ecrire. Dans cet exemple, 
nous ecrivons des octets du tableau byteArray en com- 
mencant a la position 0 et en ecrivant 10 octets. 

Si le volume des donnees que vous ecrivez est important, il 
devient plus efEcace d'encapsuler le flux de sortie du socket 
dans une instance Buf f eredOutputStream, comme ceci : 

DataOutputStream out = new DataOutputStream(new 
Buf f eredOutputStream(socket .getOutputStream( ) ) ) ; 

Au lieu de passer directement le flux de sortie de socket au 
constructeur DataOutputStream, nous creons d'abord une 
instance Buf f eredOutputStream et la passons au construc- 
teur DataOutputStream. 

Dans cet exemple, nous avons utilise la methode write ( ), 
mais DataOutputStream possede bien d'autres methodes 
pour ecrire des donnees depuis n'importe quel type de don- 
nees Java primitif, dont les suivantes : write(), writeBoo- 
lean ( ) , writeByte ( ) , writeBytes ( ) , writeChar ( ) , writeChars ( ) , 
writeDouble ( ) , writeFloat ( ) , writelnt ( ) , writeLong ( ) et write- 
Short(). Pour plus de details sur 1' utilisation de ces metho- 
des de la classe DataOutputStream, consultez le JavaDoc a 
l'adresse http:/ /java.sun.com/j2se/1.5.0/ docs/ api/ 
java/io/DataOutputStream.html. 

Lire des donnees serialisees 



ObjectlnputStream in = 

*»new ObjectlnputStream(socket.getlnputStream()) ; 
Object o = in.readObject() ; 



Le Java permet de serialiser les instances d'objet et de les 
ecrire dans un fichier ou sur un reseau. Cet exemple mon- 
tre comment lire un objet serialise depuis un socket reseau. 
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II requiert que vous ayez precedemment cree un socket 
au serveur avec lequel vous souhaitez communiquer. 
Pour plus de details sur la creation de 1'instance de socket, 
consultez l'exemple "Contacter un serveur" de ce chapitre. 

Dans cet exemple, nous appelons la methode getlnput- 
Stream() de 1'instance de socket afin d'obtenir une refe- 
rence au flux d'entree du socket. Avec cette reference, 
nous pouvons instancier un ObjectlnputStream. La classe 
Obj ectlnputStream est utilisee pour deserialiser des don- 
nees et des objets primitifs precedemment ecrits en utili- 
sant un Obj ectOutputStream. Nous utilisons la methode 
readObject() de l'objet ObjectlnputStream pour lire un 
objet depuis le flux. L'objet peut ensuite etre transtype en 
son type attendu. Par exemple, pour lire un objet Date 
depuis le flux, nous utiliserions la ligne suivante : 

Date aDate = (Date) in . readObj ect ( ) ; 

Tous les champs de donnees qui ne sont pas transitoires et 
statiques retrouvent la valeur qui etait la leur lorsque 
l'objet a ete serialise. 

Seuls les objets qui supportent Finterface java.io.Seria- 
lizable ou j ava. io . Externalizable peuvent etre lus 
depuis des flux. Lors de l'implementation d'une classe 
serialisable, il est vivement recommande de declarer un 
membre de donnees serialVersionUID. Ce champ fournit 
un numero de version qui est utilise lors de la deserialisa- 
tion pour verifier que l'emetteur et le recepteur d'un 
objet serialise ont charge pour cet objet des classes compa- 
tibles en termes de serialisation. Si vous ne declarez pas 
explicitement ce champ, un serialVersionUID par defaut 
est automatiquement calcule. Ce serialVersionUID par 
defaut tient finement compte des particularites de detail 
de la classe. Si vous apportez des modifications mineures a 
une classe et que vous souhaitiez conserver le meme 
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numero de version en considerant que cette implementa- 
tion reste compatible avec la version courante, vous devez 
declarer votre propre serialVersionUID. 

Ecrire des donnees serialisees 



ObjectOutputStream out = 

>»new ObjectOutputStream (socket .getOutputStream() ) ; 
out . writeOb j ect ( myOb j ect ) ; 



Le Java permet de serialiser les instances d'objet et de les 
ecrire dans un fichier ou sur un reseau. Cet exemple mon- 
tre comment lire un objet serialise depuis un socket 
reseau. II requiert que vous ayez precedemment cree un 
socket au serveur avec lequel vous souhaitez communi- 
quer. Pour plus de details sur la creation de l'instance de 
socket, consultez 1' exemple "Contacter un serveur" de ce 
chapitre. 

Dans cet exemple, nous appelons la methode getOutput- 
Stream() de l'instance de socket pour obtenir une refe- 
rence au flux de sortie du socket. Avec cette reference, 
nous instancions un ObjectOutputStream. La classe Object- 
OutputStream est utilisee pour serialiser des donnees et des 
objets primitifs. Nous utilisons la methode writeObj ect ( ) 
de ObjectOutputStream pour ecrire un objet dans le flux. 

Tous les champs de donnees qui ne sont pas transitoires et 
statiques sont preserves dans la serialisation et restaures 
lorsque l'objet est deserialise. Seuls les objets qui suppor- 
tent l'interface java.io.Serializable peuvent etre ecrits 
dans des flux. 
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Lire une page Web via HTTP 



URL url = new URL( "http: //www. timothyfisher.com" ) ; 
HttpURLConnection http = new HttpURLConnection(url) ; 
InputStream in = http.getlnputstream() ; 



Cet exemple presente un autre moyen de lire des don- 
nees depuis le reseau avec une programmation de plus 
haut niveau que le niveau socket auquel se cantonnaient 
les precedents exemples. Le Java peut communiquer 
avec une URL sur le protocole HTTP grace a la classe 
HttpURLConnection. Ici, nous instancions un objet URL en 
passant une chaine d'URL valide au constructeur URL. 
Ensuite, nous instancions un HttpURLConnection en passant 
l'instance url au constructeur HttpURLConnection. La 
methode getlnputstream( ) est appelee pour obtenir un 
flux d'entree afin de lire les donnees depuis la connexion 
d'URL. A l'aide du flux d'entree, nous pouvons ensuite 
lire le contenu de la page Web. 

II est aussi possible de lire le contenu d'une URL en uti- 
lisant directement la classe URL, comme ceci : 

URL url = new URL( "http: / /www. timothyf isher. corn" ) ; 

url.getContent() ; 

La methode getContent() retourne un Object. Celui-ci 
peut etre un InputStream ou un objet contenant les don- 
nees. Par exemple, la methode getContent( ) peut retour- 
ner un objet String stockant le contenu d'une URL. La 
methode getContent ( ) que nous venons d'utiliser est en 
fait un raccourci du code suivant : 

url. openConnect ion .getContent ( ) ; 
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La methode openConnection ( ) de la classe URL retourne un 
objet URLConnection. II s'agit de l'objet dans lequel la 
methode getContent ( ) se trouve en fait implementee. 

HttpURLConnection fournit des methodes specifiques au 
HTTP qui ne sont pas disponibles dans les classes plus 
generales URL ou URLConnection. Par exemple, on peut 
utiliser la methode getResponseCode ( ) pour obtenir le 
code d'etat d'un message de reponse HTTP. Le HTTP 
definit egalement un protocole pour rediriger les requetes 
vers un autre serveur. La classe HttpURLConnection con- 
tient des methodes qui comprennent cette fonctionnalite 
egalement. Par exemple, si vous souhaitez operer une 
requete a un serveur et suivre toutes les redirections qu'il 
retourne, vous pouvez utiliser le code suivant pour defmir 
cette option : 

URL url = new URL( "http: / /www. timothyf isher. com" ) ; 
HttpURLConnection http = new HttpURLConnection(url) ; 
http.setFollowRedircts(true) ; 

L'option est en fait positionnee a true par defaut. Le cas 
pratique le plus utile consistera done au contraire a posi- 
tionner l'option de suivi des redirections a false lorsque 
vous ne souhaitiez pas automatiquement etre redirige vers 
un autre serveur que celui sur lequel votre requete portait 
initialement. Cette mesure restrictive pourrait notamment 
etre envisagee avec certaines applications de securite, lors- 
que vous ne faites confiance qu'a certains serveurs specifies. 

Les pages Web qui contiennent des donnees sensibles 
sont generalement protegees par un protocole de secu- 
rite appele SSL (Secure Sockets Layer). Les pages prote- 
gees par SSL sont designees par le prefixe "https" dans 
la chaine d'URL, au lieu du prefixe "http" habituel. 
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LeJDK standard inclut une implementation du SSL 
dans le cadre de JSSE (Java Secure Socket Extension). Pour 
recuperet une page protegee par SSL, vous devez utiliser la 
classe HttpsURLConnection au lieu de HttpURLConnection. 
HttpsURLConnection gere tous les details du protocole 
SSL, en toute transparence. Pour plus d'inforniations sur 
l'utilisation du SSL et les autres fonctionnalites de securite 
fournies par JSSE, consultez le guide de reference JSSE 
propose par Sun a l'adresse : http://java.sun.com/j2se/ 
1.5.0/ docs/ guide/ security /jsse/JSSERefGuide.html. 



11 

Serveurs reseau 



En pratique, il y a bien plus de chances que vous ecriviez 
du code de client reseau que du code de serveur reseau. 
Toutefois, bon nombre d'applications integrent a la fois 
des fonctionnalites client et des fonctionnalites serveur. Le 
Java propose par chance un excellent support pour les 
deux. 

Le paquetage java.net fournitles fonctionnalites de com- 
munication reseau cote serveur que nous utiliserons dans 
ce chapitre. La plate-forme J2EE (que nous n'abordons 
pas dans ce livre) propose de nombreux services reseau 
supplementaires dont un support complet du developpe- 
ment Web Java cote serveur. Parmi les technologies 
reseau incluses dans la plate-forme J2EE, on peut citer les 
servlets, les EJB et le JMS. 
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Creer un serveur et accepter 
une requete 



public static final short PORT = 9988; 
ServerSocket server = new ServerSocket(PORT) ; 
while ((clientSock = server. accept ( )) != null) { 
// Traiter la demande du client 

} 



Cet exemple utilise une instance ServerSocket pour 
creer un serveur ecoutant sur le port 9988. Nous passons 
le port sur lequel nous souhaitons que le serveur ecoute 
au constructeur du ServerSocket. Une fois le socket ser- 
veur cree, nous appelons la methode accept ( ) pour atten- 
dre une connexion client. 

La methode accept ( ) bloque l'execution jusqu'a ce 
qu'une connexion avec un client soit operee. Lorsqu'une 
connexion est etablie, une nouvelle instance Socket est 
retournee. 

Si un gestionnaire de securite est utilise, sa methode check- 
Accept () est appelee avec clientSock. getlnetAddress() .get- 
HostAddress( ) et clientSock. getPort ( ) en arguments, afin 
de s'assurer que l'operation est autorisee. Cette verifica- 
tion peut lever une exception SecurityException. 

Les exemples de ce chapitre utilisent tous la classe Serve r- 
Socket. Elle est utilisee par le serveur pour attendre et eta- 
blir les connexions client. 

L'exemple precedent l'a montre : lorsque vous commencez 
par creer une classe ServerSocket, vous devez specifier un 
port a ecouter pour les requetes entrantes. La classe Server- 
Socket elle-meme n'est pas utilisee pour la communication 
avec le client, mais uniquement pour etablir une connexion 
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avec lui. Lorsque ServerSocket accepte une connexion client, 
une instance Socket standard est retournee. C'est cette ins- 
tance qui est utilisee pour communiquer avec le client. 

Pour plus d'informations sur la maniere d'ecrire votre 
code lorsque vous vous attendrez a devoir gerer de nom- 
breuses requetes clientes simultanees, consultez Pexemple 
"Gerer plusieurs clients" de ce chapitre. 

Retourner une reponse 



Socket clientSock = serverSocket. accept () ; 
DataOutputStream out = 

i»new DataOutputStream (clientSock. getOutputStreamO) ; 
out.writelnt(someValue); 
out. close () ; 



Cet exemple montre comment retourner une reponse du 
serveur au client. La methode accept ( ) de l'instance Ser- 
verSocket retourne une instance Socket lorsqu'une con- 
nexion est etablie avec un client. Nous obtenons ensuite 
le flux de sortie de ce socket en appelant la methode 
getOutputStreamO de cet objet. Nous utilisons le flux de 
sortie pour instancier un DataOutputStream et appelons la 
methode writelnt( ) de ce dernier pour ecrire une valeur 
entiere envoyee sous forme de donnees binaires au client. 
Pour finir, nous fermons le socket en utilisant la methode 
close( ) du Socket. 

Cet exemple utilise la methode write ( ) , mais DataOutput- 
Stream possede bien d'autres niethodes pour ecrire des don- 
nees depuis n'iniporte quel type de donnees Java primitif, et 
notamment les suivantes : write () , writeBoolean ( ) , write- 
Byte(), writeBytes(), writeChar(), writeChars( ), writeDou- 
ble ( ) , writeFloat ( ) , writelnt ( ) , writeLong ( ) et writeShort ( ) . 
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Pour plus d'informations sur l'utilisation de ces methodes 
et des autres methodes de la classe DataOutputStream, 
consultez laJavaDoc a l'adresse http://java.sun.com/j2se/ 
1.5.0/docs/api/java/io/DataOutputStream.html. 

Si vous souhaitez ecrire des donnees texte au client, utili- 
sez le code suivant : 

Socket clientSock = serverSocket . accept () ; 

PrintWriter out = new PrintWriter(new 
OutputSt reamWriter (clientSock . getOutputStream ( ) ) , true) ; 

out. println( "Hello World"); 

out.close( ) ; 

Au lieu de creer un DataOutputStream, nous creons cette 
fois un OutputStreamWriter et un PrintWriter. La methode 
print () du PrintWriter permet d'ecrire une chaine de 
texte a destination du client. Le second parametre passe au 
constructeur PrintWriter definit l'option de purge auto- 
matique. La valeur true amene les methodes println(), 
printf ( ) et format ( ) a vider automatiquement le tampon 
de sortie. Comme notre exemple utilise la methode 
println(), il n'est pas necessaire d'appeler explicitement 
la methode flush ( ). Enfin comme toujours, lorsque nous 
avons fini d'utiliser le PrintWriter, nous appelons la 
methode close ( ) pour fermer le flux. 



Retourner un objet 



Socket ClientSock = serverSocket. accept () ; 
ObjectOutputStream os = 

»»new ObjectOutputStream(clientSock.getOutputStream( )); 
// Retourner un objet 
os.writeObject(new Date()); 
os.close() ; 
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Cet exemple retourne un objet serialise au client. Nous 
obtenons une instance Socket que retourne la methode 
accept () du ServerSocket une fois qu'une connexion a 
un client est etablie. Nous creons alors une instance 
Obj ectOutputStream et passons le flux de sortie obtenu 
depuis le socket client. Ob] ectOutputStream est utilisee 
pour ecrire des types de donnees primitifs et des graphes 
d'objets Java vers un OutputStream. Dans cet exemple, 
nous ecrivons un objet Date dans le flux de sortie puis fer- 
mons ce flux. 

La methode writeObject() serialise l'objet passe en para- 
metre. Dans cet exemple, il s'agit d'un objet Date. Tous 
les champs de donnees qui ne sont pas transitoires et dyna- 
miques sont preserves dans la serialisation et restaures lors- 
que l'objet est deserialise. Seuls les objets qui supportent 
l'interface java.io.Serializable peuvent etre serialises. 

Le projet open source XStream de codehaus.org propose 
une alternative interessante aux classes Obj ectOutput- 
Stream et ObjectlnputStream. XStream fournit des imple- 
mentations de ObjectlnputStream et Obj ectOutputStream 
qui permettent aux flux d'objets d'etre serialises ou deseria- 
lises en XML. La classe ObjectlnputStream standard utilise 
un format binaire pour les donnees serialisees. La sortie 
serialisee des classes XStream fournit pour sa part les clas- 
ses serialisees dans un format XML facile a lire. Pour plus 
d'informations sur XStream et pour telecharger ce projet, 
rendez-vous a l'adresse http://xstream.codehaus.org/ 
index.html. 
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Gerer plusieurs clients 



while (true) { 

Socket clientSock = socket. accept () ; 
new Handler(clientSock) .start() ; 

} 



Pour gerer plusieurs clients, il suffit de creer un thread 
pour chaque requete entrante a traiter. Dans cet exemple, 
nous creons un nouveau thread pour gerer la connexion 
cliente entrante immediatement apres avoir accepte la 
connexion. Ce procede permet de liberer notre thread 
d'ecouteur de serveur qui peut retourner ecouter les 
connexions clientes suivantes. 

Dans cet exemple, nous nous trouvons a l'interieur d'une 
boucle while infinie : des qu'un thread est engendre pour 
gerer une requete entrante, le serveur retourne immedia- 
tement attendre la requete suivante. La classe Handler que 
nous utilisons pour demarrer le thread doit etre une sous- 
classe de la classe Thread ou doit implementer Pinterface 
Runnable. Le code utilise dans l'exemple est correct si 
la classe Handler est une sous-classe de la classe Thread. Si la 
classe Handler implemente au contraire l'interface Runnable, 
le code de demarrage du thread devient alors le suivant : 

Thread thd = new Thread(new Handler(clientSock) ) ; 
thd. start (); 

Voici l'exemple d'une classe Handler simple qui etend la 
classe Thread : 

class Handler extends Thread { 
Socket sock; 

Handler(Socket socket) { 
this. sock = socket; 

} 
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public void run() { 
DatalnputStream in = 

new Dat alnput St ream (sock. get Input St ream ( ) ) ; 
PrintStream out = 
^new PrintStream(sock.getOutputStream() , true); 

// Gestion de la requete cliente 

sock. close ( ) ; 

} 

} 

Cette classe peut etre utilisee pour gerer des requetes 
clientes entrantes. L'implementation concrete de la ges- 
tion des requetes specifiques dans le code est volontaire- 
ment masquee ici, aux fins de l'illustration. Lorsque la 
methode start () de cette classe est appelee, comme c'est 
le cas dans notre exemple precedent, la methode run() 
definie ici est executee. start () est implementee dans la 
classe de base Thread : nous n'avons pas a la redefinir dans 
notre implementation de Handler. 

Lors de la creation d'une solution multithreadee de ce type, 
il peut aussi etre interessant de creer un systeme de pooling 
des threads. Dans ce cas, vous creerez un pool de threads 
au demarrage de Implication au lieu d'engendrer un nou- 
veau thread pour chaque requete entrante. 

Le pool de threads contient un nombre fixe de threads 
pouvant executer des taches. Ce systeme evite que l'appli- 
cation ne cree un nombre excessif de threads qui pour- 
raient grever les performances systeme. Un tres bon article 
(en anglais) concemant le pooling des threads peut etre 
consulte a l'adresse http://www.informit.com/arti- 
cles/article.asp?p=30483&seqNum=3&rl=l. Pour plus 
d'informations sur l'utihsation des threads, consultez le 
Chapitre 15, "Utiliser des threads". 
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Servir du contenu HTTP 



Socket client = serverSocket.accept(); 
Buff eredReader in = new BufferedReader 

(new InputSt reamReader (client . getlnputSt ream ( ) ) ) ; 
// Avant de servir une reponse, on lit habituellement 
// 1' entree cliente et on traite la requete. 
PrintWriter out = 

i»new PrintWriter (client . getOutputStream ( ) ) ; 
out.println("HTTP/1.1 200"); 
out.println("Content-Type: text/html") ; 
String html = "<html><head><title>Test Response" + 
*»"</title></head><body>Just a test</bodyx/html>" ; 
out.printlnf'Content-length: " + html.length()) ; 
out.println(html) ; 
out. f lush () ; 
out. close () ; 



Cet exemple montre comment servir du contenu HTML 
tres simple via HTTP. Pour commencer, nous acceptons 
une connexion avec un client, creons un BufferedReader 
pour lire la requete cliente et creons un PrintWriter que 
nous utilisons pour retransmettre le HTML via HTTP au 
client. Les donnees que nous ecrivons vers le PrintWriter 
constituent le minimum necessaire pour creer un message 
de reponse HTTP valide. Notre reponse est composee de 
trois champs d'en-tete HTTP et de nos donnees HTML. 
Nous commencons notre reponse en specifiant la version 
HTTP et un code de reponse dans la ligne suivante : 

out.println("HTTP/1.1 200"); 

Nous indiquons le HTTP version 1.1 et le code de 
reponse 200. Ce code signale que la requete a reussi. A la 
ligne suivante, nous signalons que le type de contenu 
retourne est du HTML. D'autres types de contenu peuvent 
etre retournes pour un message de reponse HTTP valide. 
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Par exemple, la ligne suivante specifie que la reponse cor- 
respond a du texte brut et non du code HTML : 
out .println( "Content-Type: text /plain" ) ; 

Ensuite, nous ecrivons l'en-tete Content-length. Celui-ci 
specifie la longueur du contenu retourne, sans tenir 
compte des champs d'en-tete. Apres cela, nous ecrivons le 
message HTML a retourner. Pour finir, nous purgeons le 
flux Buf f eredReader et le fermons avec les methodes 
flush() et close(). 

Info 

Cette technique est utile pour les besoins simples en matiere 
de service HTTP, mais il n'est pas recommande d'ecrire de tou- 
tes pieces un serveur HTTP complet en Java. Un excellent ser- 
veur HTTP, gratuit et open source, est disponible dans le cadre 
du projet Jakarta d'Apache : le serveur Tomcat. Pour plus 
d'informations sur Tomcat et pour en telecharger les fichiers, 
accedez a http://jakarta.apache.org/tomcat/. Tomcat sert du 
contenu sur HTTP mais fournit egalement un conteneur de ser- 
vlets pour gerer les servlets Java et les JSP. 
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Envoyer et recevoir 
des e-mails 



L'e-mail est utilise dans de nombreuses applications. II 
est fort probable qu'a un stade ou un autre de vos projets 
de developpement, vous soyez conduit a prendre en 
charge des courriers electroniques dans l'une de vos 
applications Java. 

Le Java facilite Fintegration des fonctionnalites de messa- 
gerie electronique a vos applications Java grace a l'API 
JavaMail. Cette API est une extension du Java que vous 
devez telecharger separement. Elle ne fait pas partie du 
paquetage JDK standard propose en telechargement. Les 
classes utiles qui constituent l'API JavaMail se trouvent 
dans le paquetage javax.mail. LAPI JavaMail actuelle 
requiert le JDK 1.4 ou une version ulterieure. Les versions 
anterieures du JDK necessitent des versions egalement 
anterieures de 1API JavaMail. 
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Ce chapitre traite de l'envoi et de la reception d'e-mails 
a partir d'une application Java. L'integration des capacites 
de messagerie electronique a votre application Java consti- 
tue un excellent ajout dans de nombreuses applications. 
En pratique, ces fonctionnalites peuvent etre utiles pour 
envoyer des alertes par e-mail, transmettre automatique- 
ment des journaux et des rapports et plus generalement, 
communiquer avec les utilisateurs. 

Vue d'ensemble de I'API JavaMail 

JavaMail fournit des fonctionnalites pour envoyer et rece- 
voir des e-mails. Des fournisseurs de service s'ajoutent 
comme composants additionnels a l'API JavaMail pour 
offrir des implementations de differents protocoles de 
messagerie. L'implementation Sun inclut des fournisseurs 
de services pour IMAP, POP3 et SMTP. JavaMail fait 
egalement partie de Java Enterprise dans J2EE. 

Pour telecharger 1' extension JavaMail, rendez-vous a l'adresse 

http://java.sun.com/products/javamail/downloads/ 

index.html. 

Pour utiliser l'API JavaMail, vous devez egalement telechar- 
ger et installer l'extension JAF (JavaBeatis Activation Frame- 
work) depuis http://java.sun.com/products/javabeans/ 
jaf/ downloads/index.html. 

En plus des exemples traites dans ce chapitre, vous pouvez 
trouver des informations detaillees completes sur l'utilisa- 
tion de l'API JavaMail grace au lien JavaMail de reseau des 
developpeurs Sun (en anglais) : http://java.sun.com/ 
products/javamail/index.jsp. 
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Envoyer des e-mails 



Properties props = new Properties ( ); 

props . put ( "mail . smtp . host " , " mail . yourhost . com " ) ; 

Session session = Session. getDefaultInstance(props, null); 

Message msg = new MimeMessage(session) ; 

msg.setFrom(new InternetAddress( "tim@timothyfisher.com" ) ) ; 

internetAddress toAddress = 

*»new InternetAddress ( " kerry@timothyf isher . com" ) ; 



Cet exemple envoie un message electronique en texte 
brut a l'aide d'un serveur SMTP. Six etapes de base doi- 
vent etre imperativement suivies lorsque vous souhaitez 
envoyer un e-mail avec l'API JavaMail : 

1. Vous devez creer un objet java.util. Properties, que 
vous utiliserez pour passer des informations concernant 
le serveur de messagerie. 

2. Vous devez placer le nom d'hote du serveur de messa- 
gerie SMTP dans l'objet Properties, ainsi que toutes 
les autres proprietes a definir. 

3. Vous devez creer des objets Session et Message. 

4. Vous devez definir les adresses e-mail du destinataire et 
de l'expediteur du message ainsi que son sujet dans 
l'objet Message. 

5. Vous devez definir le texte du message dans l'objet 
Message. 

6. Vous devez appeler la methode Transport . send ( ) pour 
envoyer le message. 

L'exemple precedent suit chacune de ces etapes pour 
creer et envoyer un message electronique. Notez que les 
adresses de provenance (From) et de destination (To) sont 
creees sous forme d'objets InternetAddress. L'objet 
InternetAddress represente une adresse e-mail valide. 
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Une exception est levee si vous tentez de creer un objet 
InternetAddress en utilisant un format d'adresse e-mail 
invalide. Lorsque vous specifiez les destinataires To, vous 
devez aussi specifier leur type. Les types valides sont TO, CC 
et BCC. lis sont representes par les constantes suivantes : 
Message. RecipientType. TO 
Message . RecipientType . CC 
Message . RecipientType . BCC 

msg . addRecipient (Message . RecipientType .TO, toAddress) ; 
msg .setSubject ( "Test Message" ) ; 
msg . setText ( "This is the body of my message."); 
Transport. send(msg) ; 

La classe Message est une classe abstraite definie dans le 
paquetage javax.mail. Une sous-classe qui l'implemente 
fait partie de l'implementation standard de JavaMail : la 
classe MimeMessage. C'est cette implementation que nous 
utilisons dans l'exemple au debut de la section. La classe 
MimeMessage represente un message electronique de style 
MIME. Elle devrait vous suffire pour la plupart de vos 
besoins en matiere de messagerie electronique. 

Dans cet exemple, nous utiliserons l'objet Properties pour 
ne passer que l'hote de messagerie SMTP. II s'agit de 
l'unique propriete qu'il est obligatoire de definir, mais 
d'autres proprietes supplementaires peuvent aussi etre spe- 
cifiers. 

Info 

Consultez le sommaire concernant le paquetage javax.mail 
dans la JavaDoc pour plus de details sur d'autres proprietes 
de messagerie liees qui peuvent etre passees dans l'objet 
Properties : http://java.sun.eom/javaee/5/docs/api/javax/mail/ 
package-summary.html. 
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Envoyer des e-mails MIME 



String html = "<html><head><title>Java Mail</title></head>" 

"<body>Some HTML content. </body></html>"; 
Multipart mp = new MimeMultipart() ; 
BodyPart textPart = new MimeBodyPart( ); 
textPart. set Text ("This is the message body."); 
BodyPart htmlPart = new MimeBodyPart( ); 
htmlPart.setContent(html, "text/html") ; 
mp . addBodyPart (textPart ) ; 
mp . addBodyPart ( htmlPart ) ; 
msg.setContent(mp) ; 
Transport. send(msg) ; 



MIME est l'acronyme de Multimedia Internet Mail Exten- 
sions. Ce standard est supporte par tous les principaux 
clients de messagerie. II constitute le moyen standard 
d'associer des pieces jointes aux messages. II permet de 
joindre aux e-mails une variete de types de contenu dont 
des images, des videos et des fichiers PDF. L'API JavaMail 
supporte egalement les messages MIME. II est meme 
presque aussi facile de creer un message MIME avec des 
pieces jointes qu'un message standard en texte brut. 

Dans cet exemple, nous creons et envoyons un message 
MIME contenant un corps en texte brut et une piece 
jointe HTML. 

Pour creer un message multipartie, nous utilisons la classe 
Multipart du paquetage javax.mail. La classe MimeMulti- 
Part du paquetage j avax. mail. Internet fournit une imple- 
mentation concrete de la classe abstraite Multipart et utilise 
des conventions MIME pour les donnees multiparties. La 
classe MimeMultiPart permet d'ajouter plusieurs parties de 
corps de message representees sous forme d'objets MimeBo- 
dyPart. Le contenu des parties de corps est defmi en utili- 
sant la methode setText() pour les parties de corps en 
texte brut et setContent ( ) pour les autres types de parties. 
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Ensuite, nous utilisons la niethode setContent ( ) en pas- 
sant un objet contenant la partie de corps avec une chaine 
specifiant le type MIME que nous ajoutons. Ici, nous 
ajoutons une partie de corps HTML et specifions done le 
type MIME text /html. 

Le code presente dans l'exemple se concentre specifique- 
ment sur les etapes d'envoi du message relatives au stan- 
dard MIME. Voici un exemple plus complet qui inclut 
toutes les etapes necessaires a la realisation de cette tache : 

Properties props = new Properties( ); 

props . put ( "mail . smtp. host " , "mail. you rhost . com" ) ; 

Session session = Session. getDefaultlnstancefprops, null); 

Message msg = new MimeMessage( session) ; 

msg.setFrom(new InternetAddress( " timOtimothyfisher.com" ) ) ; 

InternetAddress toAddress = 

»»new InternetAddress( "kerry@timothyf isher . com" ) ; 

msg .addRecipient (Message . RecipientType .TO, toAddress) ; 

msg.setSubject ( "Test Message" ) ; 

String html = "<html><head><title>Java Mail</title> 
*»</head>" + "<body>Some HTML content. </body></html>" ; 

Multipart mp = new MimeMultipart( ) ; 

BodyPart textPart = new MimeBodyPart ( ); 

textPart . setText ( "This is the message body."); 

BodyPart htmlPart = new MimeBodyPart ( ); 

htmlPart.setContent(html, "text/html") ; 

mp.addBodyPart(textPart) ; 

mp.addBodyPart(htmlPart) ; 

msg.setContent(mp) ; 

Transport. send(msg) ; 
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Info 



L'lANA (Internet Assigned Numbers Authority) propose une 
reference precise de tous les types de contenu MIME standard 
sur son site Web. Le site propose egalement une application 
permettant d'enregistrer de nouveaux types MIME. Si vous 
avez le sentiment qu'aucun type MIME existant ne correspond 
a votre contenu, vous pouvez utiliser cette application pour 
demander la creation d'un nouveau type de contenu MIME 
correspondant a votre type de contenu. Pour acceder au site 
Web de I'lANA, rendez-vous a I'adresse http://www.iana.org. 
Les types de contenu MIME peuvent etre trouves a I'adresse 
http://www.iana.org/assignments/media-types/. 



Lire un e-mail 



Properties props = new Properties () ; 

Session session = Session. getDefaultInstance(props, null); 

Store store = session. getStore( "pop3") ; 

store. connect (host, username, password); 

Folder folder = store. getFolder("INBOX"); 

folder . open ( Folder . READ_ONLY) ; 

Message message[] = folder.getMessages(); 

for (int i=0, n=message. length; i<n; i++) { 

System. out. println(i + ": " + message[i] .getFrom() [0] + 

k»"\t" + message[i].getSubject()); 

String content = message[i] .getContent() .toString() ; 

System . out . print ( content . substring (0 , 1 00) ) ; 

} 

folder. close(false) ; 
store. close() ; 



Dans cet exemple, nous nous connectons a un serveur de 
messagerie POP3 et recuperons tous les messages dans le 
dossier INBOX (boite de reception). L'API JavaMail facilite 
considerablement cette tache. 
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Voici les etapes generales a suivre lorsque vous utilisez 
l'API JavaMail pour lire des messages depuis un serveur de 
messagerie POP : 

1. Vous devez obtenir un objet Session. 

2. Vous devez obtenir un objet Store a partir de l'objet 
Session. 

3. Vous devez creer un objet Folder pour le dossier que 
vous souhaitez ouvrir. 

4. Vous devez ouvrir le dossier et recuperer les messages. 
Un dossier peut contenir des sous-dossiers : il convient 
done de recuperer egalement les messages de ces dos- 
siers en procedant de maniere recursive. 

Dans cet exemple, nous obtenons une instance par 
defaut de l'objet Session en utilisant la methode statique 
getDef aultlnstance ( ) . L'objet Session represente une 
session de messagerie. A partir de cet objet, nous obte- 
nons ensuite un objet Store qui implemente le protocole 
POP3. L'objet Store represente un entrepot de messages 
et son protocole d'acces. Si par exemple, nous souhai- 
tions nous connecter a un serveur de messagerie IMAP 
au lieu d'un serveur POP3, nous pourrions modifier 
cette ligne de code afin d'obtenir un entrepot IMAP au 
lieu d'un entrepot POP3. Nous devrions egalement 
inclure un fichier JAR supplementaire qui supporte le 
protocole IMAP. Sun fournit le fichier imap. jar dans le 
cadre de la distribution JavaMail. Nous nous connectons a 
un entrepot POP3 en appelant la methode connect ( ) de 
l'objet Store et en passant un hote, un nom d'utilisateur 
et un mot de passe. 
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Dans le reste de l'exemple, nous recuperons le dossier 
INBOX et tous les messages qu'il contient. Nous imprimons 
l'expediteur (From), l'objet du message et les cent premiers 
caracteres du corps de chaque message dans le dossier 
INBOX. 

La classe Folder contient egalement une methode list() 
qui n'est pas utilisee dans cet exemple mais permet de 
recuperer un tableau d'objets Folder representant tous les 
sous-dossiers du dossier sur lequel elle est appelee. Si le 
dossier INBOX contient de nombreux sous-dossiers, il est 
ainsi possible d'obtenir une reference a chacun d'entre 
eux a l'aide du code suivant : 
Folder folder = store. getFolder("lNBOX") ; 
folder. open ( Folder. READONLY) ; 
Folder[] subfolders = folder. list() ; 

Le tableau subfolders de cet exemple contiendra un objet 
Folder pour chaque sous-dossier du dossier INBOX. II sera 
alors possible de traiter les messages dans chacun d'entre 
eux, comme nous l'avons fait pour ceux du dossier INBOX. 
La classe Folder propose aussi une methode getFolder() 
qui prend un unique parametre de chaine et retourne un 
dossier dont le nom correspond a la chaine passee. 

Grace a la classe Folder, vous pouvez ecrire une methode 
qui parcourt l'ensemble d'un compte de messagerie et lit 
les messages des differents dossiers de l'utilisateur. 
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Acces aux bases 
de donnees 



Les bases de donnees fournissent un mecanisme de stoc- 
kage persistant pour les donnees d'application et dans bien 
des cas de figure, elles sont essentielles au fonctionnement 
des applications. Le Java propose un excellent support 
pour l'acces aux bases de donnees relationnelles avec 
l'API JDBC (Java Database Connectivity). 

Si votre application ne definit qu'un modele de donnees 
tres simple et ne requiert qu'un acces tres limite a une 
base de donnees, l'API JDBC convient bien. Au-dela 
de ce cas de figure, il peut cependant etre judicieux de 
considerer l'emploi d'un framework de base de donnees 
plutot que de programmer directement l'API JDBC. Le 
framework de persistance standard pour les applications 
d'entreprise est le framework EJB (Enterprise Java Beans). 

EJB fait partie de Java Enterprise Edition. II est considere 
comme etant excessivement complexe par bon nombre 
de developpeurs Java. Ce defaut a d'ailleurs fait le succes 
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de certaines solutions open source qui deviennent de plus 
en plus populaires. La complexite d'EJB et les problemes 
qui lui etaient associes ont heureusement ete partiellement 
resolus dans EJB 3.0. EJB 3.0 constitue une avancee 
majeure dans la bonne direction et devrait faire d'EJB une 
technologie plus conviviale pour les developpeurs. 

L'excellent framework de persistance de donnees open 
source Hibernate gagne sans cesse en popularite. II cree 
une couche de mapping objet de vos donnees relationnel- 
les. La couche de mapping objet permet de traiter les don- 
nees persistantes avec une approche orientee objet par 
opposition a l'interface SQL procedurale. Pour plus 
d'informations sur le framework Hibernate, rendez-vous 
a l'adresse http://www.hibernate.org. 

Ce chapitre se concentre purement sur Faeces aux bases 
de donnees via JDBC. Si vous utilisez un framework de 
persistance de plus haut niveau, il reste important de bien 
comprendre l'API JDBC, car elle definit les fondations sur 
lesquelles s'appuient la plupart des frameworks de plus 
haut niveau. 

Se connecter a une base 
de donnees via JDBC 

Class . forName ( " sun . jdbc .odbc . JdbcOdbcDriver" ) ; 

Connection conn = 

DriverManager-.getConnection(url, user, password); 

Pour creer une connexion de base de donnees avec 
JDBC, vous devez d'abord charger un pilote. Dans cet 
exemple, nous chargeons le JdbcOdbcDriver. Ce pilote 
fournit une connectivite a une source de donnees ODBC. 



Se connecter a une base de donnees via JDBC 143 

Nous le chargeons avec la methode Class .forName( ) . 
Les pilotes de base de donnees JDBC sont generalement 
fournis par les editeurs de bases de donnees, bien que Sun 
propose plusieurs pilotes generiques dont le pilote ODBC 
utilise dans cet exemple. Une fois le pilote charge, nous 
obtenons une connexion a la base de donnees avec la 
methode DriverManager . getConnection ( ). La syntaxe uti- 
lisee pour specifier la base de donnees a laquelle nous 
souhaitons nous connecter prend la forme d'une URL. 
Nous passons egalement un nom d'utilisateur et un mot 
de passe valides pour la connexion a la base de donnees. 
L'URL doit commencer par le prefixe jdbc: . Le reste du 
format de specification d'URL (apres le prefixe) est speci- 
fique a l'editeur. Voici la syntaxe d'URL pour se connec- 
ter a une base de donnees ODBC : 

j dbc : odbc : nomdebasededonnees 

La plupart des pilotes requierent que la chaine d'URL 
inclue un nom d'hote, un port et un nom de base de 
donnees. Voici par exemple une URL valide pour la 
connexion a une base de donnees MySQL : 

jdbcimysql: / /db.myhost.com:3306/mydatabase 

Cette URL specifie une base de donnees MySQL sur l'hote 
db.myhost.com pour une connexion sur le port 3306 avec 
le nom de base de donnees mydatabase. Le format general 
d'une URL de base de donnees MySQL est le suivant : 

jdbcimysql: 1 1 note -.port I base de donnees 

L'un des autres moyens d'obtenir une connexion de base 
de donnees consiste a utiliser JNDI. C'est en general 
l'approche que vous adopterez si vous utilisez un serveur 
d'applications comme WebLogic de BEA ou WebSphere 
d'IBM. 
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Hashtable ht = new Hashtable(); 

ht . put (Context . I N I T I AL_CONTEXT_FACTOR Y , 
■►"weblogic. jndi.WLInitialContextFactory" ) ; 

ht . put (Context . PROVIDERJJRL, " t3 : / /hostname : port " ) ; 

Context ctx = new InitialContext (ht ) ; 

javax.sql.DataSource ds = 
• ■(] avax . sql. DataSource) ctx . lookup ( "myDataSource" ) ; 

Connection conn = ds .getConnection ( ) ; 

Avec JNDI, nous creons une instance InitialContext et 
l'utilisons pour rechercher un DataSource. Ensuite, nous 
obtenons la connexion depuis l'objet de source de don- 
nees. Une autre version de la methode getConnection ( ) 
permet aussi de passer un nom d'utilisateur et un mot de 
passe pour la connexion aux bases de donnees requerant 
une authentification. 

II est important de toujours veiller a fermer la connexion 
en utilisant la methode close() de la classe Connection 
lorsque vous avez termine d'utiliser l'instance Connection. 

Envoyer une requete via JDBC 



Statement stmt = conn.createStatement( ); 
ResultSet rs = 

*»stmt.executeQuery("SELECT * from users where name= 1 tim 1 " ) ; 



Dans cet exemple, nous creons une instruction JDBC avec 
la methode createStatement ( ) de l'objet Connection et l'uti- 
lisons pour executer une requete qui retourne un ResultSet 
Java. Pour la creation de la connexion, referez-vous au pre- 
cedent exemple, "Se connecter a une base de donnees via 
JDBC". Pour realiser la requete SELECT, nous utilisons la 
methode executeQuery( ) de l'objet Statement. 
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Si vous souhaitez effectuer une operation UPDATE au lieu 
d'une requete SELECT, vous devez utiliser la methode exe- 
cuteUpdate() de l'objet Statement au lieu de sa methode 
executeQuery( ). La methode executeUpdate ( ) est utilisee 
avec des instructions SQL INSERT, UPDATE et DELETE. Elle 
retourne le compte des lignes pour les instructions INSERT, 
UPDATE ou DELETE ou 0 si l'instruction SQL ne retourne rien. 
Voici un exemple d'execution d'une instruction UPDATE : 
Statement stmt = conn . createStatement ( ); 
int result = stmt .executeUpdate ( "UPDATE users SET name= 
' tim ' where id= ' 1234' " ) ; 

II est important de se souvenir qu'il n'est possible d'ouvrir 
qu'un seul objet ResultSet a la fois par objet Statement. 
Toutes les methodes d'execution dans l'interface Statement 
ferment l'objet ResultSet courant s'il en existe deja un 
d'ouvert. Ce point est important a retenir si vous imbri- 
quez des connexions et des requetes de base de donnees. 

JDBC 3.0 a introduit une fonctionnalite de conservation 
du jeu de resultats. Elle permet de conserver plusieurs jeux 
de resultats ouverts si vous specifiez cette option lorsque 
l'objet d'instruction est cree. Pour en apprendre plus sur les 
nouvelles fonctionnalites de JDBC 3.0, consultez 1' article 
suivant (en anglais) sur le site Web DeveloperWorks d'IBM : 
http://www.128.ibm.com/ developerworks/java/ 
library /j-jdbcnew/. 

Lorsque vous travaillez avec des instructions et des resul- 
tats, veillez toujours a bien fermer les objets Connection, 
Statement et ResultSet lorsque vous en avez termine. 
Chacun de ces objets possede une methode close () per- 
mettant de le fermer afm de liberer la memoire et les 
ressources. Si vous omettez de les fermer, vous risquez 
de creer des fuites memoire dans vos applications Java. 
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Le fait de ne pas fermer une connexion peut egalement 
provoquer des cas d'interblocage dans les applications 
multithreadees. 

Si l'une de vos instructions SQL doit etre executee de nom- 
breuses fois, il est plus efficace d'utiliser une requete Prepa- 
redStatement. Pour plus d'informations a ce sujet, consultez 
l'exemple suivant, "Utiliser une instruction preparee". 

Utiliser une instruction preparee 



PreparedStatement stmnt = conn . prepareStatement ( " INSERT 

>»into users values (?,?,?,?)"); 

stmnt. setString(1 , name); 

stmnt. setString(2, password); 

stmnt. setString(3, email); 

stmnt.setlnt(4, employeeld); 

stmnt. executel)pdate( ); 



Pour creer une instruction preparee dans JDBC, vous 
devez utiliser un objet PreparedStatement au lieu d'un 
objet Statement. Dans cet exemple, nous passons le code 
SQL a la methode prepareStatement () de l'objet Connec- 
tion. Cette operation cree un objet PreparedStatement. 
Avec une instruction preparee, les valeurs de donnees 
dans l'instruction SQL sont specifiees a l'aide de points 
d'interrogation. Les veritables valeurs pour ces jokers 
representes par des points d'interrogation sont definies 
plus tard en utilisant les methodes set de PreparedState- 
ment. Les methodes set disponibles sont setArray(), 
setAsciiStream( ), setBigDecimal ( ) , setBinaryStream( ), 
setBlob(), setBoolean(), setBytef), setBytes(), setCha- 
racterstream( ), setClob(), setDate(), setDouble(), set- 
Float (), setlnt(), setLong(), setNull(), setObject(), 
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setRef(), setShort(), setString(), setTime(), setTimes- 
tamp() et setURL(). Chacune de ces methodes set est uti- 
lisee pour definir un type de donnees specifique sous 
forme de parametre dans l'instruction SQL. Par exemple, 
la methode setlnt( ) est utilisee pour definir des parame- 
tres entiers, la methode setString ( ) pour definir des para- 
metres String, etc. 

Dans cet exemple, nous positionnons trois valeurs de 
chaine et une valeur entiere avec les methodes setS- 
tring() et setlnt(). 

Chaque point d'interrogation qui apparait dans l'instruc- 
tion de requete doit avoir une instruction set corres- 
pondante qui definisse sa valeur. Le premier parametre 
des instructions set specifie la position du parametre cor- 
respondant dans l'instruction de requete. Si la valeur 1 est 
passee comme premier parametre a une instruction set, c'est 
ainsi la valeur correspondant au premier point d'interro- 
gation qui est positionnee dans l'instruction de requete. 
Le second parametre des instructions set specifie la valeur 
elle-meme du parametre. Dans notre exemple, les varia- 
bles name, password et email sont toutes censees etre de 
type String. La variable employeeld est de type int. 

Lorsque vous creez une instruction SQL que vous allez 
reutiliser plusieurs fois, il est plus efficace d'utiliser un 
objet PreparedStatement au lieu d'un objet Statement 
standard. L'instruction preparee est une instruction SQL 
precompilee qui offre une execution plus rapide une fois 
creee. 
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Recuperer les resultats 
d'une requete 



ResultSet rs = stmt.executeQueryf'SELECT name, password 
*»FR0M users where name= 1 tim 1 ") ; 
while (rs.next( )) { 

String name = rs.getString(1 ) ; 

String password = rs.getString(2) ; 

} 



Les requetes JDBC retournent un objet ResultSet. Ce 
dernier represente une table de donnees contenant les 
resultats d'une requete de base de donnees. Le contenu du 
ResultSet peut etre parcouru afin d'obtenir les resultats de 
la requete executee. Le ResultSet conserve un curseur 
qui pointe sur la ligne de donnees courante. L'objet 
ResultSet possede une methode next() qui deplace le 
curseur a la ligne suivante. La methode next() retourne 
false lorsqu'il n'y a plus de ligne dans l'objet ResultSet. 
II est ainsi possible d'utiliser une boucle while pour par- 
courir toutes les lignes contenues dans le ResultSet. 

Le ResultSet possede des methodes getter perniettant de 
recuperer les valeurs de colonne de la ligne courante. Les 
valeurs de donnees peuvent etre recuperees a l'aide du 
numero d'index ou du nom de la colonne. La numerota- 
tion des colonnes commence a 1. La casse n'est pas prise 
en compte pour les noms de colonne fournis en entree 
aux methodes getter. 

Dans cet exemple, nous obtenons un ResultSet suite a 
l'execution d'une requete SELECT. Nous parcourons en 
boucle les lignes contenues dans le ResultSet en utilisant 
la methode next() et une boucle while. Nous obtenons 
les valeurs de donnees name et password avec la methode 
getString(). 
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Rappelez-vous qu'il est conseille de fermer vos instances 
de ResultSet lorsque vous avez fini de les utiliser. Les 
objets ResultSet sont automatiquement fermes lorsque 
l'objet Statement qui les a generes est ferme, reexecute ou 
utilise pour recuperer le resultat suivant d'une sequence 
de resultats multiples. 

Utiliser une procedure stockee 



CallableStatment cs = 

*»conn.prepareCall("{ call ListAllUsers }"); 
ResultSet rs = cs.executeQuery( ); 



Les procedures stockees sont des programmes de base de 
donnees stockes et conserves dans la base de donnees 
elle-meme. Elles peuvent etre appelees depuis le code Java 
en utilisant l'interface CallableStatement et la methode 
prepareCall( ) de l'objet Connection. CallableStatement 
retourne un objet ResultSet comme le fait Statement ou 
PreparedStatement. Dans cet exemple, nous appelons la 
procedure stockee ListAllUsers sans paranietre. 

L'objet CallableStatement peut prendre des parametres 
d'entree egalement. Ceux-ci sont geres exactenient 
comme ils le sont avec un PreparedStatement. Par exem- 
ple, le code suivant montre comment appeler une proce- 
dure stockee qui utilise des parametres d'entree : 

CallableStatment cs = conn.prepareCall( "{ call 
Addlnts(?,?) }"); 

cs.setlnt(1 ,10) ; 

cs.setlnt(2,50) ; 

ResultSet rs = cs.executeQuery( ); 
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A la difference des autres types d'instructions JDBC, 
CallableStatement peut egalement retourner des parame- 
tres, appeles parametres OUT. Le type JDBC de chaque 
parametre OUT doit etre enregistre avant que l'objet 
CallableStatement puisse etre execute. Cette inscription 
s'opere avec la methode registerOutParameter ( ) . Une 
fois que l'instruction a ete executee, les parametres OUT 
peuvent etre recuperes en utilisant les methodes getter de 
CallableStatement. 

CallableStatement cs = con . prepareCall( " {call 
*-getData(?, ?)}"); 

cs . registerOutParameter ( 1 , j ava. sql .Types . INT) ; 

cs.register0utParameter(2, java. sql. Types. STRING) ; 

ResultSet rs = cs . executeQuery ( ) ; 

int intVal = cs.getlnt(1 ) ; 

String strVal = cs .getString(2) ; 

Dans cet exemple, nous appelons une procedure stockee 
nominee getData() qui possede deux parametres OUT. 
L'un de ces parametres OUT est une valeur int et l'autre 
une valeur String. Une fois ces deux parametres enregis- 
tres, nous executons la requete et obtenons leurs valeurs 
avec les methodes getlnt() et getString(). 

L'une des autres differences a remarquer tient a ce que 
les procedures stockees peuvent retourner plusieurs jeux 
de resultats. Si une procedure stockee retourne plus d'un 
jeu de resultats, on peut utiliser la methode getMore- 
Results() de la classe CallableStatement pour fermer 
lejeu de resultats courant et pointer sur le suivant. 
La methode getResultSet ( ) peut etre appelee ensuite 
pour recuperer lejeu de resultats nouvellement designe. 
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Voici un exemple qui retourne plusieurs jeux de resultats 
et utilise ces methodes pour recuperer chacun d'entre eux : 

int i; 
String s; 

callablestmt. execute () ; 
rs = callablestmt. getResultSet ( ) ; 
while (rs.next()) { 
i = rs.getlnt(1 ) ; 

} 

callablestmt .getMoreResults( ) ; 
rs = callablestmt. getResultSet ( ) ; 
while (rs.next()) { 
s = rs.getString(1 ) ; 

} 

rs. close(); 
callablestmt. close() ; 

Ici, nous positionnons la valeur int i avec les resultats du 
premier jeu de resultats et la variable String s avec ceux 
du second. 
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XML 



Le XML (extensible Markup Language) est derive du SGML 
(Standard Generalized Markup Language), tout comme le 
HTML (Hypertext Markup Language) . En fait, le XML est 
meme analogue en bien des points au HTML, a ceci pres 
qu'en XML, il vous revient de definir vos propres balises. 
Vous n'etes pas cantonne a un jeu predefini de balises 
comme vous l'etes en HTML. Le XHTML, pour sa part, 
est une version du HTML compatible avec le standard 
XML. 

Le XML est couramment utilise comme format generique 
pour l'echange de donnees entre serveurs et applications, 
dans les processus de communication entre couches appli- 
catives ou pour le stockage de donnees complexes comme 
les documents de traitement de texte voir les fichiers gra- 
phiques. 

Le XML a ete largement adopte dans tous les secteurs 
d'industrie et par la majorite des langages de programma- 
tion. La plupart d'entre eux proposent maintenant un 
support pour le traitement des donnees XML. Le Java n'y 
fait pas exception et fournit d'excellents outils pour le 
traitement des documents XML, que ce soit pour creer 
ou pour lire des donnees XML. 



154 CHAPITRE 14 XML 



Ce chapitre requiert des connaissances en XML. Si vous 
souhaitez apprendre ce langage ou parfaire vos connaissan- 
ces dans ce domaine, consultez XML de Michael Morrison 
(CampusPress, 2006). 

Deux API de parsing XML courantes independantes du 
langage sont definies par le W3C (World Wide Web 
Consortium) : les API DOM et SAX. Le DOM (Document 
Object Model) est un parseur qui lit un document XML 
entier et construit un arbre d'objets Node, que Ton appelle 
le DOM ou le modele objet du document. Le DOM livre 
une representation parsee complete du document XML 
dont vous pouvez extraire des elements a tout moment. 
SAX (Simple API for XML) n'est pas un veritable parseur en 
soi, mais plus exactement une API qui definit un meca- 
nisme de gestion des evenements pouvant servir a parser 
des documents XML. Vous pouvez creer des methodes de 
rappel qui sont appelees par 1API SAX au moment ou des 
elements specifiques du document XML sont atteints. 

L'iniplenientation SAX scanne le document XML en 
appelant les methodes de rappel des qu'elle rencontre le 
debut et la fin d'elements particuliers du document XML. 
Avec SAX, le document XML n'est jamais completement 
stocke ou represente en memoire. 

L'implementation Java du traitement XML est appelee 
JAXP (Java API for XML Processing). JAXP permet aux 
applications de parser et de transformer des documents 
XML sans l'aide d'une implementation de traitement 
XML. JAXP contient un parseur DOM et un parseur 
SAX ainsi qu'une API XSLT pour la transformation des 
documents XML. XSLT est Facronyme de extensible Sty- 
lesheet Language Transformations. La technologie XSLT 
permet de transformer les documents XML en les faisant 
passer d'un format a un autre. JAXP fait partie integrante 
du JDK 1 .4 et de ses versions ulterieures. 
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Parser du XML avec SAX 



XMLReader parser = XMLReaderFactory.createXMLReader 

( "org . apache . xerces . parsers . SAXParser " ) ; 
parser. setContentHandler(new MyXMLHandler ( )); 
parser . parse ( " document . xml " ) ; 



L'API SAX opere en scannant le document XML de bout 
en bout et en fournissant des rappels pour les evenements 
qui se produisent. Ces evenements peuvent correspondre 
a la rencontre du debut d'un element, de sa fin, du debut 
d'un attribut, de sa fin, etc. Ici, nous creons une instance 
XMLReader en utilisant le SAXParser. Une fois l'instance de 
parseur creee, nous definissons un gestionnaire de con- 
tenu avec la methode setContentHandler( ). Le gestion- 
naire de contenu est une classe qui definit les difFerentes 
methodes de rappel appelees par le parseur SAX lorsque le 
document XML est parse. Ici, nous creons une instance 
de MyXMLHandler, une classe que nous allons devoir ensuite 
implementer, en guise de gestionnaire. Ensuite, nous 
appelons la methode parse () et lui passons le nom d'un 
document XML. Des lors, le traitement SAX demarre. 

Le code suivant presente une implementation d'exemple 
de la classe MyXMLHandler. La classe Def aultHandler que 
nous etendons est une classe de base par defaut pour les 
gestionnaires d'evenements SAX. 
class MyXMLHandler extends Def aultHandler { 

public void startElement (String uri, String 
localName, String qname, Attributes attributes) { 

// Traiter le debut de 1' element 

} 

public void endElement (String uri, String localName, 
String qname) { 
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// Traiter la fin de l'element 

} 

public void characters(char[ ] ch, int start, int length) { 
// Traiter les caracteres 

} 

public MyXMLHandler( ) 

throws org .xml . sax .SAXException { 
super( ); 

} 

} 

Cette implementation d'exemple n'implemente que trois 
methodes : startElement ( ), endElement() et characters () . 
La methode startElement ( ) est appelee par le parseur SAX 
lorsqu'il rencontre le debut d'un element dans le document 
XML. De la meme maniere, la methode endElement ( ) est 
appelee lorsqu'il rencontre la fin d'un element. La 
methode characters ( ) est appelee pour signaler la presence 
de donnees de caractere dans un element. Pour obtenir une 
description complete de toutes les methodes qui peuvent 
etre redefinies dans le gestionnaire SAX, consultez la Java- 
Doc Def aultHandler : http://java.sun.eom/j2se/l.5.0/ 
docs/ api/ org/xml/sax/helpers/DefaultHandler.html. 

Dans cet exemple, le parseur SAX sous-jacent est Xerces. 
Nous le definissons dans l'appel de methode suivant : 

XMLReader parser = XMLReaderFactory . createXMLReader 
» ( "org . apache . xerces . parsers .SAXParser" ) ; 

JAXP est concu pour permettre des implementations 
de parseur externes : si vous preferez un autre parseur a 
Xerces, rien ne vous empeche de l'utiliser avec le code 
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de cet exemple. Veillez cependant a bien inclure l'imple- 
mentation du parseur dans votre chemin de classe. 

SAX est generalement plus efficace au niveau de la 
memoire que le parseur DOM car le document XML 
n'est pas tout entier stocke en memoire. L'API DOM lit 
le document entier en memoire pour le traiter. 

Parser du XML avec DOM 



File file = new File("document.xml") ; 
DocumentBuilderFactory f = 

•»DocumentBuilderFactory . newlnstance ( ) ; 
DocumentBuilder p = f .newDocumentBuilder() ; 
Document doc = p.parse(file) ; 



Dans cet exemple, nous utilisons les trois classes Docu- 
mentBuilderFactory, DocumentBuilder et Document pour 
demarrer le parsing d'un document XML avec un parseur 
DOM. Le parsing s'opere avec la classe DocumentBuilder. 
Cette derniere definit l'API permettant d'obtenir des ins- 
tances de Document DOM a partir d'un document XML. 
La classe DocumentBuilder peut parser du XML depuis une 
variete de sources d'entree, dont des InputStream, des 
File, des URL et des SAXlnputSources. Ici, nous parsons le 
XML a partir d'une source d'entree File. La methode 
parse () de la classe DocumentBuilder parse le document 
XML et retourne un objet Document. 

L'objet Document represente le DOM du document XML. 
Cette instance Document peut ensuite etre utilisee pour 
acceder aux composants du document XML, comme ses 
entites, ses elements, ses attributs, etc. 
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L'objet Document est un conteneur pour une collection 
hierarchique d'objets Node qui represente la structure du 
document XML. Les nceuds ont un parent, des enfants 
ou des attributs associes. Le type Node contient trois sous- 
classes qui representent les principaux composants du 
document XML : Element, Text et Attr. Considerons 
maintenant un exemple de parsing d'un DOM avec la 
classe Document. Voici le document XML d'exemple que 
nous allons utiliser : 

<Location> 
<Address> 
<City>Flat Rock</City> 
<State>Michigan</State> 
</Address> 
</Location> 

En supposant que nous avons deja obtenu une instance 
Document avec la technique de parsing presentee dans 
P exemple de depart, il suffira d'utiliserle code Java suivant 
pour extraire les valeurs de texte de villes (city) et d'etats 
(state) : 

NodeList list = document .getElementsByTagName( "City" ) ; 

Element cityEl = ( Element )list . item(0) ; 

String city = ( (Text)cityEl.getFirstChild( ) ) .getData( ) ; 

NodeList list = document .getElementsByTagName( "State" ) ; 

Element stateEl = (Element ) list . item(0) ; 

String state = ( (Text)stateEl.getFirstChild() ) .getData() ; 

La methode getElementsByTagName ( ) retourne un NodeList 
contenant tous les elements qui correspondent au nom 
passe. Notre document d'exemple ne contient qu'un seul 
element City et un seul element State : nous recuperons 
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done siniplenient le premier element (index zero) de la 
liste de nceuds et le transtypons en un Element. Les ele- 
ments City et State possedent chacun un enfant, de type 
Text. Nous utilisons la methode getData() du type Text 
pour recuperer la valeur de ville (city) et d'etat (state). 

A la difference du parseur SAX, le parseur DOM lit le 
document XML entier en memoire, le parse et le traite a 
cet endroit. Ce procede est moins efficace en termes de 
consommation de memoire que celui du parseur SAX qui 
ne stocke pas le document XML entier en memoire mais 
le scanne progressivement a la maniere d'un flux. 

Utiliser une DTD pour verifier 
un document XML 



DocumentBuilderFactory factory = 

Document Builder Factory .newlnstance( ) ; 
factory . setValidating ( true) ; 

DocumentBuilder builder = factory. newDocumen t Builder ( ) ; 



Les DTD (Document Type Definition) sont des fichiers qui 
definissent la maniere dont un document XML particulier 
doit etre structure. Une DTD peut ainsi specifier quels 
elements et quels attributs sont autorises dans un docu- 
ment. Les documents XML qui se conforment a une 
DTD sont consideres etre valides. Les documents XML 
syntaxiquement corrects mais qui ne se conforment pas a 
une DTD sont siniplenient dits bien formes. 

Pour valider un document avec une DTD, vous devez 
appeler la methode setValidating ( ) de l'instance Docu- 
mentBuilderFactory et lui passer la valeur true. Tous les 
documents XML parses sont ensuite valides par rapport 
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aux DTD specifiees dans leur en-tete. Voici une decla- 
ration de DTD classique en haut d'un document XML : 

<!D0CTYPE people SYSTEM "f ile : baseball . dtd "> 

Cette declaration attache le fichier baseball. dtd stocke 
dans le systeme de fichiers local sous forme de DTD au 
document XML dans lequel elle est declaree. 

Lorsque vous specifiez la validation DTD, une exception 
est lancee depuis la methode parse ( ) de la classe Document- 
Builder si le document XML que vous parsez ne se con- 
forme pas a la DTD. 

Le standard XML Schema est une technologie plus 
recente qui offre les mem.es avantages que les DTD. Les 
schemas XML definissent le balisage attendu des docu- 
ments XML, comme le font les DTD. L'avantage des 
documents de schema tient cependant a ce qu'ils sont 
eux-memes des documents XML et que vous n'avez done 
pas besoin d'un autre parseur pour les lire, alors que les 
DTD ne sont pas des documents XML valides. Les DTD 
respectent la syntaxe XBNF (eXtended Backus-Naur Form). 
Pour utiliser un schema, vous devez utiliser la methode 
setSchema() du DocumentBuilderFactory au lieu de la 
methode setValidating ( ) , comme ceci : 

DocumentBuilderFactory factory = 

DocumentBuilderFactory . newlnstance ( ) ; 

factory. setSchema(schema) ; 

DocumentBuilder builder = factory. newDocumentBuilder( ) ; 

La methode setSchema() prend une instance d'un objet 
Schema. Nous n'entrerons pas ici dans les considerations 
de detail concernant Futilisation des schemas, mais vous 
pouvez consulter la JavaDoc de DocumentBuilderFactory 
pour plus d'infomiations sur l'implementation des schemas 
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en Java, a l'adresse suivante : http://java.sun.com/j2se/ 
1.5.0/ docs/api/javax/ xml/parsers/DocumentBuil- 
derFactory.html. 

Pour plus d'informations sur les schemas en general, con- 
sultez la documentation XML Schema a l'adresse : 
http : / /www. w3 . or g/TR/ xmlschema- 1 / . 

Creer un document XML avec DOM 



DocumentBuilderFactory fact = 

•»DocumentBuilderFactory.newInstance( ) ; 
DocumentBuilder builder = fact.newDocumentBuilder( ); 
Document doc = builder. newDocument( ); 
Element location = doc. createElement(" Location"); 
doc.appendChild(location) ; 
Element address = doc. createElement(" Address") ; 
location. appendChild(address) ; 
Element city = doc.createElement("City"); 
address. appendChild(city) ; 

line . appendChild (doc . createTextNode ( " Flat Rock" ) ) ; 
Element state = doc. createElement( "State" ) ; 
address . appendChild (state ) ; 

state . appendChild ( doc . createTextNode ( " Michigan " ) ) ; 
( (org . apache . crimson .tree . XmlDocument ) doc ) 
»».write(System.out) ; 



Cet exemple utilise l'API DOM et JAXP pour creer un 
document XML. Le segment XML cree est le suivant : 

<Location> 
<Address> 
<City>Flat Rock</City> 
<State>Michigan</State> 
</Address> 
</Location> 
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La principale classe utilisee ici est la classe org.w3c.dom 
.Document. Elle represente le DOM d'un document 
XML. Nous creons une instance de la classe Document en 
utilisant un DocumentBuilder obtenu a partir d'un Docu- 
mentBuilderFactory. Chaque element du document XML 
est represente dans le DOM sous forme d'instance Element. 
Dans le document XML que nous creons, nous avons 
construit des objets Element appeles Location, Address, 
City et State. Nous ajoutons 1' element de niveau racine 
(Location) a l'objet de document avec la methode append- 
Child() de l'objet Document. La classe Element contient 
elle aussi une methode appendChild( ) que nous utilisons 
pour construire la hierarchie du document sous Felement 
racine. 

L'API DOM permet tout aussi facilement de creer un 
Element avec des attributs. Le code suivant peut etre uti- 
lise pour ajouter un attribut "id" possedant la valeur 
"home" a 1' element Location : 
location. setAttribute ( "id" , "home" ) ; 

Dans cet exemple, le parseur DOM sous-jacent est Crim- 
son. Cette implementation apparait dans la derniere ligne, 
reproduite ici : 

( ( org. apache. crimson.tree.XmlDocument) doc) 
>».write(System.out) ; 

JAXP est concu pour supporter les implementations de 
parseur externes : si vous preferez un autre parseur a 
Crimson, rien ne vous empeche de l'utiliser avec le code 
de cet exemple. Veillez cependant a bien inclure l'imple- 
mentation du parseur dans votre chemin de classe. 

L'API JDOM est une alternative a l'API JAXP pour le 
travail avec les documents XML. II s'agit d'un projet open 
source standardise par le biais du JCP (Java Community 
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Process), sous la reference JSR 102. Pour plus d'informa- 
tions sur l'API JDOM, consultez le site www.jdom.org. 
JDOM propose une API Java native en remplacement de 
l'API DOM standard pour lire et creer des documents 
XML. De nombreux developpeurs trouvent 1API JDOM 
plus facile a utiliser que l'API DOM lors de la creation de 
documents XML. 

Transformer du XML avec des XSLT 



StreamSource input = 

'•new StreamSource(new File ("document .xml") ) ; 
StreamSource stylesheet = 

•new StreamSource(new File("style.xsl")) ; 
StreamResult output = new StreamResult(new File ("out. xml")); 
TransformerFactory tf = TransformerFactory.newInstance() ; 
Transformer tx = tf.newTransformer (stylesheet ) ; 
tx. transform (input, output); 



Le XSLT est un standard pour la transformation des docu- 
ments XML qui permet d'en modifier la structure a l'aide 
de feuilles de style XSL. Le paquetage javax. xml. trans- 
form contient l'API permettant d'utiliser des transforma- 
tions XSLT standard en Java. XSL est l'acronyme de 
extensible Stylesheet Language. XSLT est l'acronyme de XSL 
Transformation (transformation XSL), un langage qui per- 
met de restructurer completement les documents XML. 
Lorsque vous utiliserez des XSLT, vous aurez en general 
un document XML d'entree et une feuille de style XSL 
d'entree et produirez en les combinant un document 
XML de sortie. Le type du document de sortie ne se 
limite cependant pas au XML. Bien d'autres sortes de 
documents de sortie peuvent etre creees a l'aide de trans- 
formations XSL. 
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Dans cet exemple, nous creons des instances StreamSource 
pour les documents utilises en entree du processus de 
transformation : le document XML a transformer et la 
feuille de style XSL contenant les instructions de transfor- 
mation. Nous creons aussi un objet StreamResult qui ser- 
vira a recueillir le resultat de l'ecriture du document de 
sortie. Nous obtenons ensuite une instance Transformer 
generee a partir d'une instance Tranf ormerFactory. 

Le flux de feuille de style est ensuite passe a la methode 
newTranformer( ) de l'objet Transf ormerFactory pour creer 
un objet Transformer. Pour finir, nous appelons la methode 
transf orm() du Transformer afin de transformer notre 
document XML d'entree en un document de sortie mis 
en forme avec la feuille de style selectionnee. 

Le XSL peut etre une technologie tres efficace pour les 
developpeurs. Si votre application Web doit etre accessi- 
ble a partir d'une variete de peripheriques differents, 
comme des assistants personnels, des navigateurs Web et 
des telephones cellulaires, vous pourrez ainsi utiliser des 
XSLT pour transformer votre sortie afin d'en adapter le 
format a chacun des peripheriques concernes, sans pro- 
grammer chaque fois une sortie separee. Les XSLT sont 
aussi tres utiles pour creer des sites multilingues. La sortie 
XML peut en effet etre transformee en plusieurs langages 
grace a des transformations XSLT. 
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Utiliser des threads 



Le threading designe la methode utilisee par une applica- 
tion logicielle pour accomplir plusieurs processus a la fois. 
En Java, un thread est une unite d'execution programme 
qui s'execute simultanement a d'autres threads. 

Les threads sont frequemment utilises dans les applications 
d'interface utilisateur graphique (GUI). Dans une applica- 
tion de ce type, un thread peut ecouter l'entree du clavier 
ou d'autres peripheriques de saisie pendant qu'un autre 
traite la commande precedente. 

La communication reseau implique aussi souvent l'usage 
du multithreading. En programmation reseau, un thread 
peut ecouter les requetes de connexion, pendant qu'un 
autre traite une requete precedente. Les minuteurs utili- 
sent aussi couramment les threads. lis peuvent etre 
demarres sous forme de thread s'executant independam- 
ment du reste de l'application. Dans tous ces exemples, le 
multithreading permet a une application de poursuivre le 
traitement tout en executant une autre tache qui peut 
prendre plus de temps et provoquerait de longs delais en 
l'absence de multithreading. 
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Le Java facilite grandenient Pecriture d' applications multi- 
threadees. La conception d'applications multithreadees etait 
tres complexe en C, mais en Java, tout est bien plus simple. 

Lancer un thread 



public class MyThread extends Thread { 
public void run() { 
// Executer des taches 

} 

} 

// Code pour utiliser MyThread 
new MyThread () . start () ; 



II existe deux techniques principales pour ecrire du code 
qui s'execute dans un thread separe. Vous pouvez imple- 
menter l'interface j ava . lang . Runnable ou etendre la classe 
java. lang .Thread. Dans 1'un ou l'autre cas, vous devez 
implementer une methode run() qui contient le code a 
executer dans le thread. 

Dans cet exemple, nous avons etendu la classe java. lang 
. Thread. A 1' emplacement ou nous souhaitons demarrer le 
thread, nous instancions notre classe MyThread et appelons 
la methode start ( ) heritee de la classe Thread. 

Voici maintenant le code permettant d' executer un 
thread avec l'autre technique, en implementant l'inter- 
face Runnable : 

public class MyThread2 implements Runnable { 
public void run() { 
// Executer des taches 

} 

} 

// Code pour utiliser MyThread2 
Thread t = new Thread (MyThread2) ; 
t. start ( ) ; 
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L'interface Runnable est en general implementee lorsqu'une 
classe etend une autre classe et ne peut done etendre la 
classe Thread egalement. Le Java ne supporte que l'heritage 
unique : une classe ne peut etendre deux classes differentes. 
La methode a l'interieur de laquelle nous demarrons le 
thread est ici legerement differente. Au lieu d'instancier 
la classe precedemment definie, comme nous l'avons fait 
en etendant l'interface Thread, nous instancions un objet 
Thread et passons la classe implementant Runnable en 
parametre au constructeur Thread. Ensuite, nous appelons 
la methode start () de Thread, qui demarre le thread et 
planifie son execution. 

L'un des autres moyens pratiques de creer un thread con- 
sists a implementer l'interface Runnable en utilisant une 
classe interne anonyme, comme ceci : 

public class MyThread3 { 
Thread t; 

public static void main(String argv[]) { 
new MyThread3( ) ; 

} 

public MyThread3( ) { 
t = new Thread(new Runnable( ) { 
public void run( ) { 
/ / Executer des taches 

} 

}); 

t. start ( ); 

} 

} 
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Dans cet exemple, tout le code est contenu a l'interieur 
d'une unique classe et se trouve done parfaitement encap- 
sule. On peut ainsi mieux voir ce qui se passe. Notre 
implementation Runnable est definie sous forme de classe 
interne au lieu de creer explicitement une classe qui 
implemente l'mterface Runnable. Cette solution est ideale 
pour les petites methodes qui n'interagissent que tres peu 
avec des classes externes. 

Arreter un thread 



public class StoppableThread extends Thread { 
private boolean done = false; 

public void run( ) { 
while (Idone) { 
System . out . println ( "Thread running " ) ; 
try { 
sleep(500) ; 

} 

catch (InterruptedException ex) { 
// Ne rien faire 

} 

} 

System . out . println ( "Thread finished . " ) ; 

} 

public void shut Down ( ) { 
done = true; 

} 

} 



Si vous souhaitez creer un thread que vous pourrez arreter 
avant la fin de son execution (autrement dit, avant le retour 
de la methode run ( )), la meilleure solution consiste a utili- 
ser un drapeau booleen dont vous testerez l'etat au debut 
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d'une boucle globale. Dans cet exemple, nous creons un 
thread en etendant la classe Thread avec notre classe Stop- 
pableThread. A l'interieur de la methode run ( ) , nous creons 
une boucle while qui verifie l'etat d'un drapeau booleen 
done. Tant que le drapeau done vaut false, le thread 
continue. Pour arreter le thread, il suffit a un processus 
externe de positionner le drapeau a true. La boucle while 
de la methode run( ) quitte alors et termine ce thread. 

La classe Thread contient une methode stop() que Ton 
peut etre tente d'utiliser pour arreter le thread, mais Sun 
en deconseille l'usage, car si votre thread opere sur un 
objet de structure de donnees et que vous appelez soudai- 
nement sa methode stop( ), les objets peuvent etre laisses 
dans un etat incoherent. Si d'autres threads attendent 
que cet objet particulier soit libere, ils risquent alors de se 
bloquer et d' attendre indefiniment. Des problemes d'inter- 
blocage peuvent avoir lieu. La methode stop() est ega- 
lement deconseillee depuis le JDK 1.2. Si vous utilisez la 
methode stop() dans Tun de ces JDK, le compilateur 
genere des avertissements a ce sujet. 

L'article de reference (en anglais) a l'adresse suivante 
explique les raisons pour lesquelles la methode stop( ) est 
deconseillee : http://java.sun.eom/j2se/l.5.0/docs/ 
guide/misc/threadPrimitiveDeprecation.html. 

Attendre qu'un thread se termine 



Thread t = new Thread (MyThread) ; 
t.start(); 

// Realiser d'autres operations 
t.join(); 

// Continue apres que le thread t se termine 
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Dans certains cas, vous pourrez souhaiter qu'un thread 
d'execution attende qu'un autre thread ait termine avant 
de poursuivre. La jonction des threads est une methode 
courante pour interrompre un thread jusqu'a ce qu'un 
autre thread ait acheve son travail. Dans cet exemple, 
nous demarrons le thread t de l'interieur du thread qui 
execute ces lignes de code. Des operations sont ensuite 
executees, puis nous appelons la methode join() de 
l'objet de thread lorsque nous souhaitons arreter l'execu- 
tion du thread en attendant que le thread t en ait fini. 
Lorsque t a fini, 1' execution se poursuit jusqu'aux instruc- 
tions qui suivent la ligne dans laquelle nous avons appele 
la methode join(). Si le thread t a deja completement 
termine lorsque nous appelons join(), cette derniere 
retourne immediatement l'execution. 

Une autre forme de la methode join() prend un para- 
metre long contenant une valeur en millisecondes. 
Lorsque cette methode est utilisee, le thread appelant 
attend au maximum le nombre de millisecondes specifie 
avant de continuer, meme si le thread sur lequel la 
methode join( ) est appelee n'a pas fini. Enfin, une troi- 
sieme implementation de la methode join( ) prend deux 
parametres, une valeur long en millisecondes et une 
valeur int en nanosecondes. Cette methode se comporte 
exactement comme la version a un parametre, sauf que 
les valeurs en millisecondes et en nanosecondes sont 
additionnees pour determiner la duree pendant laquelle 
le thread appelant doit attendre avant de continuer. 
Cette methode offre un controle plus fin sur le temps 
d'attente. 
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Synchroniser des threads 



public synchronized void myMethod() { 
// Executer quelque chose 

} 



La synchronisation est utilisee pour empecher que plu- 
sieurs threads puissent acceder simultanement a des 
sections specifiques du code. Le mot-cle synchronized 
qui apparait dans cet exemple permet de synchroniser 
une methode ou un bloc de code afin qu'un seul thread 
puisse l'executer a la fois. Dans le contexte de cet exem- 
ple, si un thread execute actuellement myMethod ( ) , tous les 
autres threads qui tentent d'executer la meme methode 
sur la meme instance d'objet sont bloques a l'exterieur de 
la methode jusqu'a ce que le thread courant termine son 
execution et la retourne de myMethod ( ). 

Dans le cas des methodes non statiques, la synchronisation 
s'applique uniquement a l'instance d'objet sur laquelle un 
autre thread execute la methode. Les autres threads gardent 
la possibilite d'executer la meme methode mais sur une ins- 
tance differente. Au niveau de l'instance, le verrouillage 
s'applique a toutes les methodes synchronisers de l'instance. 
Aucun thread ne peut appeler la moindre methode syn- 
chro nisee d'une instance dont un thread execute deja une 
methode synchronisee. Dans le cas des methodes statiques, 
seul un thread a la fois peut executer la methode. 

Le mot-cle synchronized peut egalement etre applique a 
des blocs de code, sans necessairement concerner 1' ensem- 
ble d'une methode. Le bloc de code suivant opere une 
synchronisation de ce type : 

synchronizedfmyObject) { 

// Faire quelque chose avec myObject 

} 
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Lors de la synchronisation d'un bloc de code, vous devez 
specifier l'objet sur lequel la synchronisation doit etre 
operee. Bien souvent, le but est d'operer la synchronisa- 
tion sur l'objet qui contient le bloc de code, ce qui peut 
etre fait en passant l'objet this comme objet a synchroni- 
ser, comme ceci : 

synchronized(this) { 

// Faire quelque chose 

} 

L'objet passe au mot-cle synchronized est verrouille 
lorsqu'un thread execute le bloc de code qu'il entoure. 

La synchronisation est generalement utilisee lorsque l'acces 
concurrentiel par plusieurs threads peut risquer d'endom- 
mager des donnees partagees. 

Une classe dite thread-safe garantit qu'aucun thread n'utilise 
un objet qui se trouve dans un etat incoherent. Le bloc de 
code suivant presente un exemple de classe qui risquerait 
d'etre problematique si elle n'etait pas rendue thread-safe 
en appliquant le mot-cle synchronized a la methode 
adjust (). En general, les classes qui possedent des mem- 
bres de donnees d'instance sont susceptibles de poser des 
problemes dans les environnements multithreades. A titre 
d'exeniple, supposons que deux threads executent la 
methode adjust () et que cette derniere ne soit pas syn- 
chroniser Le thread A execute la ligne size=size+1 et se 
trouve in terrompu juste apres la lecture de la valeur size, 
mais avant d'attribuer la nouvelle valeur a size. 

Le thread B s'execute maintenant et appelle la methode 
reset(). Cette methode positionne la variable size a 0. 
Le thread B est ensuite interrompu et retourne le controle 
au thread A, qui reprend maintenant l'execution de l'ins- 
truction size=size+1, en incrementant la valeur de size 
d'une unite. Au final, la methode reset () ne parait pas 
avoir ete appelee. Ses effets sont contrecarres par les 
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imprevus du multithreading. Si le mot-cle synchronized 
est applique a ces methodes, ce cas de figure ne se produit 
plus, car un seul thread est alors autorise a executer l'une 
ou l'autre des methodes. Le deuxieme thread doit atten- 
dre que le premier ait termine l'execution de la methode. 

public class ThreadSaf eClass { 
private int size; 

public synchronized void adjust () { 
size = size + 1 ; 
if (size >= 100) { 
size = 0; 

} 

} 

public synchronized void reset () { 
size = 0; 

} 

} 

La programmation thread-safe ne s'applique qu'a une appli- 
cation qui possede plusieurs threads. Si vous ecrivez une 
application qui n'utilise pas de multithreading, vos soucis 
s'envolent. Avant d'opter pour ce choix, considerez cepen- 
dant aussi que votre application ou votre composant peu- 
vent etre reutilises a d'autres endroits. Quand vous 
n'utilisez qu'un seul thread, posez-vous cette question : 
est-il possible qu'un autre projet utilise ce composant dans 
un environnement multithreade ? 

La synchronisation peut etre utilisee pour rendre un objet 
thread-safe, mais n'oubliez pas qu'elle implique un com- 
promis en termes de performances. L'execution des 
methodes synchronises est consequemment plus lente en 
raison de la surcharge liee au verrouillage des objets. 
Veillez ainsi a ne synchroniser que les methodes qui 
requierent veritablement d'etre thread-safe. 
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Suspendre un thread 



MyThread thread 
thread. start () ; 
while (true) { 



= new MyThread () ; 



// Quelques taches... 

synchronized (thread) { 
thread. doWait = true; 

} 

// Quelques taches... 

synchronized (thread) { 
thread. doWait = false; 
thread. notify() ; 

} 

} 

class MyThread extends Thread { 
boolean doWait = false; 
public void run() { 
while (true) { 
// Quelques taches... 
synchronized (this) { 
while (doWait) { 
wait(); 
} 

catch (Exception e) { 
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Cet exemple montre comment suspendre un thread 
depuis un autre thread. Nous utilisons la variable doWait 
comme drapeau. Dans la methode run() de MyThread, 
nous verifions l'etat de ce drapeau apres avoir realise une 
tache dans une boucle afin de determiner si nous devons 
suspendre l'execution du thread. Si le drapeau doWait vaut 
true, nous appelons la methode Ob] ect . wait ( ) pour sus- 
pendre l'execution du thread. 

Lorsque nous souhaitons relancer le thread, nous posi- 
tionnons le drapeau doWait a false et appelons la 
methode thread . Notify ( ) pour relancer le thread et 
poursuivre sa boucle d'execution. 

La suspension du thread est tres simple a realiser, comme 
le montre le fragment suivant : 

long numMilliSecondsToSleep = 5000; 
Thread. sleep (numMilliSecondsToSleep) ; 

Ce code suspend le thread courant pendant 5 000 millise- 
condes, soit 5 secondes. En plus de ces methodes, deux 
methodes appelees Thread . suspend ( ) et Thread . resume( ) 
fournissent un mecanisme pour la suspension des threads, 
mais elles sont deconseillees. Elles peuvent en effet sou- 
vent creer des interblocages. Nous ne les mentionnons ici 
que pour signaler qu'il convient de ne pas les utiliser. 
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Lister tous les threads 



public static void listThreads() { 
ThreadGroup root = 

Thread. currentThread() .getThreadGroup() .getParent() ; 
while (root.getParent() != null) { 
root = root.getParent() ; 

} 

visitGroup(root, 0); 



public static void visitGroup (ThreadGroup group, int level) { 
int numThreads = group. activeCount() ; 
Thread [] threads = new Thread [ numThreads ] ; 
group. enumerate (threads, false); 
for (int i=0; i<numThreads; i++) { 

Thread thread = threads[i]; 

printThreadlnfo(thread) ; 

} 

int numGroups = group. activeGroupCount() ; 
ThreadGroup[ ] groups = new ThreadGroup [numGroups] ; 
numGroups = group. enumerate(groups, false); 

for (int i=0; i<numGroups; i++) { 
visitGroup (groups [i] , level+1); 

} 

} 

private static void printThreadlnfo (Thread t) { 
System. out. printlnf'Thread: " + t.getName( ) + 
*»" Priority: " + t.getPriority( ) + (t.isDaemon( )?" 
^•Daemon":"") + (t.isAlive( )?"":" Not Alive")); 

} 



Cet exemple liste tous les threads en cours d'execution. 
Chaque thread reside dans un groupe de threads et chaque 
groupe de threads peut contenir des threads et d'autres 
groupes de threads. La classe ThreadGroup permet de 
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regrouper des threads et d'appeler des methodes qui 
affectent tous les threads dans le groupe de threads. Les 
ThrearJGroup peuvent egalement contenir des ThreadGroup 
enfants. Les ThreadGroup organisent ainsi tous les threads 
en une hierarchie complete. 

Dans cet exemple, nous parcourons en boucle tous les 
groupes de threads afin d'imprimer des informations 
concernant chacun des threads. Nous commencons par 
retrouver le groupe de threads racine. Ensuite, nous utili- 
sons la methode visitGroup() pour consulter de maniere 
recursive chaque groupe de threads situe sous le groupe 
racine. Dans la methode visitGroup( ), nous enumerons 
d'abord tous les threads contenus dans le groupe puis 
appelons la methode printThreadlnfof ) pour imprimer le 
nom, la priorite et l'etat (demon ou non, vivant ou non) 
de chaque thread. Apres avoir parcouru en boucle tous les 
threads dans le groupe courant, nous enumerons tous les 
groupes qu'il contient et operons un appel recursif a la 
methode visitGroup() pour chaque groupe. Cet appel 
de methode se poursuit jusqu'a ce que tous les groupes et 
tous les threads aient ete enumeres et que les informations 
concernant chacun des threads aient ete imprimees. 

Les groupes de threads sont souvent utilises pour regrou- 
per des threads lies ou similaires, par exemple selon la 
fonction qu'ils realisent, leur provenance ou le moment 
ou ils doivent etre demarres et arretes. 
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Programmation 
dynamique 
par reflexion 



La reflexion est un mecanisme permettant de decouvrir 
a l'execution des donnees concernant un programme. 
En Java, elle permet de decouvrir des informations 
concernant des champs, des methodes et des construc- 
teurs de classes. Vous pouvez aussi operer sur les champs 
et methodes que vous decouvrez de cette mamere. La 
reflexion permet ainsi de realiser en Java ce que Ton 
appelle couramment une programmation dynamique. 

La reflexion s'opere en Java a l'aide de 1' API Java Reflec- 
tion. Cette API est constitute de classes dans les paqueta- 
ges java.lang et java.lang. reflect. 
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Entre autres possibilities, l'API Java Reflection permet 
notamment : 

■ de determiner la classe d'un objet ; 

■ d'obtenir des informations concernant des modifica- 
teurs, des champs, des methodes, des constructeurs et 
des superclasses ; 

■ de retrouver les declarations de constantes et de 
methodes appartenant a une interface ; 

■ de creer une instance d'une classe dont le nom n'est pas 
connu jusqu'a l'execution ; 

■ de retrouver et de defrnir la valeur d'un champ d'objet ; 

■ d'invoquer une methode sur un objet ; 

■ de creer un nouveau tableau, dont la taille et le type 
de composant sont inconnus jusqu'au moment de 
l'execution. 

L'API Java Reflection est couramment utilisee pour creer 
des outils de developpement tels que des debogueurs, des 
navigateurs de classes et des generateurs d'interfaces utili- 
sateur graphiques. Ces types d'outils requierent souvent 
d'interagir avec des classes, des objets, des methodes et des 
champs sans que Ton puisse savoir lesquels des la compila- 
tion. L'application doit alors retrouver ces elements en 
cours d'execution et y acceder de maniere dynamique. 

Obtenir un objet Class 



MyClass a = new MyClass(); 
a.getClass(); 



L'operation la plus simple en programmation reflexive 
consiste a obtenir un objet Class. Une fois l'instance 
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d'objet Class recuperee, il est ensuite possible d'obtenir 
toutes sortes d'informations concernant la classe et meme 
de la manipuler. Dans cet exemple, nous utilisons la 
methode getClass() pour obtenir un objet Class. Cette 
methode est souvent utile avec une instance d'objet dont 
vous ne connaissez pas la classe de provenance. 

Plusieurs autres approches permettent d'obtenir un objet 
Class. Dans le cas d'une classe dont le nom de type est 
connu a la compilation, il existe un moyen plus simple 
d'obtenir une instance de classe. Vous devez simplement 
utiliser le mot-cle de compilateur .class, comme ceci : 

Class aclass = String. class; 

Si le nom de la classe n'est pas connu a la compilation et 
se trouve seulement disponible a l'execution, vous devez 
utiliser la methode forName() pour obtenir un objet 
Class. Par exemple, la ligne de code suivante cree un 
objet Class associe a la classe java.lang. Thread : 

Class c = Class. forName( "java.lang. Thread" ) ; 

Vous pouvez aussi utiliser la methode getSuperClass() 
sur un objet Class afm d'obtenir un objet Class represen- 
tant la superclasse de la classe reflechie. Par exemple, dans 
le code suivant, l'objet Class a reflechit la classe TextField 
et l'objet Class b reflechit la classe TextComponent car 
TextComponent est la superclasse de TextField : 

TextField textField = new TextField(); 
Class a = textField .getClass( ) ; 
Class b = a.getSuperclass() ; 
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Obtenir un nom de classe 



Class c = someObject.getClass() ; 
String s = c.getName() ; 



Pour obtenir le nom d'un objet Class, il suffit d'appeler la 
methode getName() sur l'objet concerne. L'objet String 
retourne par la methode getName() est un nom de classe 
pleinement qualifie. Dans cet exemple, si la variable 
someObject est une instance de la classe String, le nom 
retourne par l'appel a getName( ) est : 
java.lang. String. 

Decouvrir des modificateurs 
de classe 



Class c = someObject. getClass() ; 
int mods = c.getModifiers() ; 
if (Modifier. isPublic(mods) ) 

System . out . println ( " public " ) ; 
if (Modifier. isAbstract(mods) ) 

System . out . println ( " abstract " ) ; 
if (Modifier. isFinal(mods) ) 

System . out . println ( " final " ) ; 



Dans les definitions de classe, plusieurs mots-cles appeles 
modificateurs peuvent preceder le mot-cle class. Ces modi- 
ficateurs sont public, abstract ou final. Pour decouvrir 
quel modificateur a ete applique a une classe, vous devez 
d'abord obtenir un objet Class representant la classe 
concernee avec la methode getClass(). Ensuite, vous 
devez appeler la methode getModif iers( ) sur l'objet de 
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classe pour recuperer une valeur int codee representant 
les modificateurs. Les methodes statiques de la classe 
java. lang . reflect .Modifier peuvent ensuite etre utilisees 
pour determiner les modificateurs qui ont ete appliques. 
Ces methodes statiques sont isPublicf), isAbstract() et 
isFinal(). 

Info 

Si I'un de vos objets de classe peut representer une interface, il 
peut aussi etre souhaitable d'utiliser la methode islnterface(). 
Cette methode retourne true si les modificateurs passes incluent 
le modificateur interface. La classe Modifier contient des 
methodes statiques supplementaires qui permettent de deter- 
miner quels modificateurs ont ete appliques aux methodes et 
variables de la classe, dont les suivantes : isPrivate(), isPro- 
tected(), isStatic(), isSynchronized(), isVolatile(), isTran- 
sient(), isNative() et isStrict(). 



Trouver des superclasses 



Class els = obj .getClass() ; 

Class superclass = cls.getSuperclass() ; 



Les ancetres d'une classe sont appeles ses superclasses. Elles 
peuvent etre retrouvees par reflexion. Une fois que vous 
avez obtenu un objet Class, vous pouvez utiliser la methode 
getSuperclass ( ) pour retrouver la superclasse de la classe. Si 
la superclasse existe, un objet Class est retourne. S'il n'y a 
pas de superclasse, la methode retourne null. Rappe- 
lez-vous que le Java ne supporte que l'heritage unique : 
chaque classe ne peut done avoir qu'une seule superclasse. 
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Plus precisement, chaque classe ne peut avoir qu'une seule 
superclasse directe. En theorie, toutes les classes ancetres 
sont considerees etre des superclasses. Pour les recuperer 
toutes, vous devez recursivement appeler la niethode get- 
Superclass() sur chacun des objets Class retournes. 

La niethode suivante inrprime toutes les superclasses asso- 
ciees a l'objet passe : 

static void printSuperclasses (Obj ect obj ) { 
Class els = obj .getClass( ) ; 
Class superclass = els .getSuperclass ( ) ; 
while (superclass != null) { 

String className = superclass. getName( ) ; 

System. out. println(className) ; 

els = superclass; 

superclass = els .getSuperclass( ) ; 

} 

} 

Les EDI (environnements de developpement integre) 
comme Eclipse incluent souvent un navigateur de classes 
qui permet au developpeur de parcourir visuellement la 
hierarchie des classes. La technique que nous venons de 
presenter est generalement utilisee pour construire ces 
navigateurs de classes. Pour developper un navigateur 
de classes visuel, votre application doit pouvoir retrou- 
ver les superclasses d'une classe donnee. 
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Determiner les interfaces 
implementees par une classe 



Class c = someObject.getClass() ; 

Class [] interfaces = c.getlnterfaces(); 

for (int i = 0; i < interfaces. length; i++) { 

String interfaceName = interfaces[i] .getName() ; 

System . out . println ( interfaceName) ; 

} 



Dans l'exemple precedent, nous avons vu comment 
retrouver les superclasses associees a une classe donnee. 
Ces superclasses sont liees au mecanisme d'heritage et 
d'extension des classes du Java. En plus des possibility 
qui vous sont offertes en matiere d'extension des classes, 
le Java vous permet egalement d'implementer des inter- 
faces. Les interfaces qu'une classe donnee a imple- 
mentees peuvent aussi etre retrouvees par reflexion. Une 
fois que vous avez obtenu un objet Class, vous devez 
utiliser la methode getlnterf aces ( ) pour recuperer les 
interfaces implementees par la classe. getlnterf aces ( ) 
retourne un tableau d'objets Class. Chaque objet du 
tableau represente une interface implementee par la 
classe concernee. Vous pouvez utiliser la methode get- 
Name () de ces objets Class pour recuperer le nom des 
interfaces implementees. 
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Decouvrir des champs de classe 



Class c = someObject.getClass() ; 

Field [] publicFields = c.getFields() ; 

for (int i = 0; i < publicFields. length; i++) { 

String fieldName = publicFields[i] .getName() ; 

Class fieldType = publicFields[i] .getType() ; 

String fieldTypeStr = fieldType. getName() ; 

System. out. println( "Name: " + fieldName); 

System. out. println( "Type: " + fieldTypeStr); 

} 



Les champs publics d'une classe peuvent etre decouverts a 
l'aide de la methode getFields( ) de l'objet Class. 

La methode getFields() retourne un tableau d'objets 
Field contenant un objet par champ public accessible. Les 
champs publics accessibles retournes ne sont pas 
necessairement des champs contenus directement dans la 
classe avec laquelle vous travaillez. II peut aussi s'agir des 
champs contenus : 

■ dans une superclasse ; 

■ dans une interface iniplementee ; 

■ dans une interface etendue a partir d'une interface 
iniplementee par la classe. 

A l'aide de la classe Field, vous pouvez recuperer le nom, 
le type et les modificateurs du champ. Ici, nous impri- 
mons le nom et le type de chacun des champs. Vous pou- 
vez egalenient retrouver et defmir la valeur des champs. 
Pour plus de details a ce sujet, consultez les exemples 
"Recuperer des valeurs de champ" et "Definir des valeurs 
de champ" de ce chapitre. 

Si vous le preferez, vous pouvez aussi recuperer un champ 
individuel d'un objet au lieu de tous ses champs si vous en 
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connaissez le nom. L'exemple suivant montre comment 
recuperer un champ unique : 

Class c = someObject .getClass( ) ; 

Field titleField = c.getField( "title" ) ; 

Ce code recupere un objet Field representant le champ 
nomme "title". 

Les methodes getFields() et getField() ne retournent 
que les membres de donnees publics. Si vous souhaitez 
recuperer tous les champs d'une classe et notamment ses 
champs prives et proteges, utilisez les methodes getDecla- 
redFields() ou getDeclaredField ( ) . Elles se comportent 
comme leurs equivalents getFields() et getField() mais 
retournent tous les champs en incluant les champs prives 
et proteges. 

Decouvrir des constructeurs 
de classe 



Class c = someOb ject. get Class () ; 

Constructor!] constructors = c.getConstructors() ; 

for (int i = 0; i < constructors. length; i++) { 

Class[] paramTypes = constructors[i] .getParameterTypes() ; 
for (int k = 0; k < paramTypes. length; k ++) { 
String paramTypeStr = paramTypes[k] .getName() ; 
System. out. print (paramTypeStr + " "); 

} 

System . out . println ( ) ; 

} 



La methode getConstructors ( ) peut etre appelee sur un 
objet Class afin de recuperer des informations concernant 
les constructeurs publics d'une classe. Elle retourne un 
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tableau d'objets Constructor, qui peuvent ensuite etre uti- 
lises pour retrouver le nom, les modificateurs et les types 
de parametre des constructeurs et les exceptions qui peu- 
vent etre levees. L'objet Constructor possede egalement 
une methode newlnstance( ) permettant de creer une 
nouvelle instance de la classe du constructeur. 

Dans cet exemple, nous obtenons tous les constructeurs 
de la classe someObject. Pour chaque constructeur trouve, 
nous recuperons un tableau d'objets Class representant 
tous ses parametres. A la fin, nous imprimons chacun des 
types de parametre pour chaque constructeur. 

Info 

Le premier constructeur contenu dans le tableau de construc- 
teurs retourne est toujours le constructeur sans argument par 
defaut lorsque ce dernier existe. S'il n'existe pas, le construc- 
teur sans argument est defini par defaut. 



Vous pouvez aussi retrouver directement un constructeur 
public individuel au lieu de recuperer tous les construc- 
teurs d'un objet pour peu que vous connaissiez les types 
de ses parametres. L'exemple suivant montre comment 
proceder : 

Class c = someObject. getClass() ; 

Class[] paramTypes = new Class[] {String . class} ; 

Constructor aCnstrct = c.getConstructor(paramTypes) ; 

Nous obtenons un objet Constructor representant le 
constructeur qui prend un unique parametre String. Les 
methodes getConstructors( ) et getConstructor( ) ne retour- 
nent que les constructeurs publics. Si vous souhaitez 
retrouver tous les constructeurs d'une classe et notamment 
ses constructeurs prives, vous devez utiliser les methodes 
getDeclaredConstructors( ) ou getDeclaredConstructor( ). 
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Celles-ci se comportent comme leurs equivalents get- 
Constructors ( ) et getConstructor( ) mais retournent tous 
les constmcteurs en incluant les constructeurs prives. 

Decouvrir des informations 
de methode 



Class c = someObject.getClass() ; 

Method [] methods = c.getMethods(); 

for (int i = 0; i < methods. length; i++) { 

String methodName = methods[i] .getName() ; 

System. out. println(" Name: " + methodName); 

String returnType = methods[i] .getReturnType() .getName() ; 

System. out. println(" Return Type: " + returnType); 

Class[] paramTypes = methods[i] .getParameterTypes(); 

System . out . print ( " Parameter Types : " ) ; 

for (int k = 0; k < paramTypes. length; k ++) { 
String paramTypeStr = paramTypes[k] .getName(); 
System. out. print (" " + paramTypeStr); 

} 

System . out . println ( ) ; 

} 



La methode getMethods() peut etre appelee sur un objet 
Class afin de recuperer des informations concernant les 
methodes publiques d'une classe. Elle retourne un tableau 
d'objets Method, qui peuvent ensuite etre utilises pour 
retrouver le nom, le type de retour, les types de parame- 
tres, les modificateurs de la classe et les exceptions qui 
peuvent etre levees. La methode Method. invoke () peut 
egalement etre utilisee pour appeler la methode. Pour plus 
d'informations sur l'invocation des methodes, consultez 
l'exemple "Invoquer des methodes" de ce chapitre. 
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Dans l'exemple precedent, une fois que nous recuperons 
le tableau de methodes, nous le parcourons en boucle 
pour iniprimer le nom, le type de retour et une liste des 
types de parametres de chacune des methodes. 

Vous pouvez aussi retrouver une methode publique indi- 
viduelle au lieu de recuperer toutes les methodes d'un 
objet, pourvu que vous connaissiez son nom et les types 
de ses parametres. L'exemple suivant montre comment 
proceder : 

Class c = someObject.getClass() ; 
Class[ ] paramTypes = 

»»newClass[] {String. class, Integer. class}; 
Method meth = c.getMethod( "setValues" , paramTypes); 

Dans cet exemple, nous obtenons un objet Method repre- 
sentant la methode nominee setvalue qui prend deux 
parametres de type String et Integer. 

Les methodes getMethods() et getMethod() dont nous 
venons de traiter retournent 1' ensemble des methodes 
publiques auxquelles il est possible d'acceder avec une 
classe. Des methodes equivalentes appelees getDeclared- 
Methods() et getDeclaredMethod( ) permettent d'obtenir 
toutes les methodes quel que soit leur type d'acces. Elles 
se component exactement de la meme maniere mais 
retournent toutes les methodes de la classe concernee 
independamment de leur type d'acces. II est ainsi possible 
d'obtenir les methodes privees egalement. 

Les EDI (environnements de developpement integre) 
comme Eclipse incluent souvent un navigateur de classes 
qui permet au developpeur de parcourir visuellement la 
hierarchie des classes. La technique que nous venons de 
presenter est generalement utilisee pour construire ces 
navigateurs de classes. Pour developper un navigateur 
de classes visuel, votre application doit avoir un moyen de 
connaitre toutes les methodes d'une classe donnee. 
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Retrouver des valeurs de champ 



Class c = anObject. get Class () ; 

Field titleField = c.getField("title") ; 

String titleVal = (String) titleField. get(anObject) ; 



Pour retrouver une valeur de champ, vous devez com- 
mencer par recuperer un objet Field pour le champ dont 
vous souhaitez connaitre la valeur. Pour plus d'informa- 
tions sur l'obtention des objets Field d'une classe, consultez 
l'exemple "Decouvrir des champs de classe" precedem- 
ment dans ce chapitre. 

La classe Field propose des methodes specialises pour 
recuperer les valeurs des types primitifs, dont getlnt(), 
getFloat() et getByte(). Pour plus de details sur les 
methodes getter de l'objet Field, consultez la JavaDoc 
(en anglais) a l'adresse suivante : http://java.sun.com/ 
j2se/1.5.0/docs/api/java/lang/reflect/Field.html. 

Pour retrouver des champs stockes sous forme d'objets et 
non comme des primitifs, vous devez utiliser la methode 
plus generale get ( ) et transtyper le resultat de retour sur le 
type d'objet approprie. Dans cet exemple, nous obtenons 
le champ nomme "title". Apres avoir recupere le champ 
sous forme d'objet Field, nous obtenons ensuite la valeur 
du champ en utilisant la methode get( ) et en transtypant 
le resultat en type String. 

Dans cet exemple, nous connaissions le nom du champ 
dont nous souhaitions retrouver la valeur. Cette valeur 
pourrait cependant etre obtenue sans meme connaitre 
son nom a la compilation, en combinant cet exemple 
avec l'exemple "Decouvrir des champs de classe" ou nous 
avons montre comment obtenir des noms de champs. 
Cette technique pourrait par exemple etre utile dans un 
outil de generateur d'interface utilisateur graphique qui 
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necessiterait d'obtenir la valeur de differents champs d'objets 
de l'interface dont les noms ne seraient pas connus avant 
1' execution. 

Definir des valeurs de champ 



String newTitle = "President"; 
Class c = someObject .getClass() ; 
Field titleField = c.getField("title") ; 
titleField . set ( someOb j ect , newTitle) ; 



Pour definir une valeur de champ, vous devez d'abord 
obtenir un objet Field pour le champ dont vous souhaitez 
definir la valeur. Pour plus d'informations sur l'obtention 
d'objets Field a partir d'une classe, consultez l'exemple 
"Decouvrir des champs de classe" precedemment dans ce 
chapitre. Referez-vous aussi a l'exemple "Retrouver des 
valeurs de champ" pour plus d'informations sur l'obtention 
des valeurs de champ. 

La classe Field possede des methodes specialisees pour defi- 
nir les valeurs des types primitifs, dont setlnt(), setFloat() 
et setByte ( ) . Pour plus de details sur les methodes set dis- 
ponibles pour l'objet Field, consultez la JavaDoc (en 
anglais) a l'adresse : http://java.sun.eom/j2se/l.5.0/ 
docs/api/java/lang/reflect/Field.html. 

Pour positionner des champs stockes sous fomie d'objets et 
non sous forme de types primitifs, vous devez utiliser la 
methode set ( ) plus generale en passant l'instance d'objet dont 
vous definissez les valeurs de champ et la valeur de champ 
comme objet. Dans cet exemple, nous positionnons le 
champ nomme "title". Apres avoir obtenu le champ sous 
forme d'objet Field, nous definissons sa valeur avec set(), 
en passant l'instance d'objet dont nous positionnons les 
valeurs de champ et la nouvelle valeur pour la chaine de titre. 
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Pour cet exemple, nous connaissions le nom du champ 
dont nous souhaitions definir la valeur. II est cependant 
possible de definir la valeur des champs dont vous ne 
connaissez pas le nom a la compilation, en combinant 
l'approche de cet exemple avec celle de F exemple 
"Decouvrir des champs de classe" precedemment dans ce 
chapitre. Cette technique peut par exemple etre utile 
pour un generateur d'interface utilisateur graphique avec 
lequel vous devez positionner la valeur de differents 
champs d'objet d'interface utilisateur graphique dont les 
noms ne peuvent etre connus avant 1' execution. 

Les debogueurs vous permettent souvent de modifier la 
valeur d'un champ au cours d'une session de debogage. 
Pour implementer ce type de fonctionnalite, le deve- 
loppeur du programme peut utiliser la technique de cet 
exemple afin de positionner la valeur des champs car il ne 
peut connaitre a la compilation le champ dont vous sou- 
haiterez positionner la valeur a l'execution. 

Invoquer des methodes 



Baseball bbObj = new Baseball(); 
Class c = Baseball. class; 

Class[] paramTypes = new Class[] {int. class, int. class}; 
Method calcMeth = c.getMethod("calcBatAvg" , paramTypes); 
Object[] * r 3 s = "ew Object[] {new lnteger(30), 
*»new Integer(100)}; 

Float result = (Float) calcMeth. invoke ( bbOb j , args); 



L'API Reflection permet d'invoquer de maniere dyna- 
mique des methodes dont vous ne connaissez pas le nom 
a la compilation. Vous devez d'abord obtenir un objet 
Method pour la methode a invoquer. Pour plus d'informa- 
tions sur l'obtention des objets Method a partir d'une 
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classe, consultez l'exemple "Decouvrir des informations 
de methode" precedemment dans ce chapitre. 

Dans l'exemple precedent, nous tentons d'invoquer une 
methode qui calcule une moyenne de reussite en baseball. 
La methode nominee calcBatAvg() prend deux parame- 
tres entiers, un compte des coups reussis et un compte des 
"presences a la batte" (at-bats). La methode retourne une 
moyenne a la batte sous forme d'objet Float. Pour l'invo- 
quer, nous suivons ces etapes : 

■ Nous obtenons un objet Method associe a la methode 
calcBatAvg() de l'objet Class qui represents la classe 
Baseball. 

■ Nous invoquons la methode calcBatAvg () en utilisant 
la methode invoke () de l'objet Method. La methode 
invoke ( ) prend deux parametres : un objet dont la classe 
declare ou herite la methode et un tableau de valeurs 
de parametre a passer a la methode invoquee. Si la 
methode est statique, le premier parametre est ignore 
et peut valoir null. Si la methode ne prend aucun para- 
metre, le tableau d'arguments peut etre de longueur 
nulle ou valoir null. 

Dans notre exemple, nous passons une instance de l'objet 
Baseball comme premier parametre a la methode invoke ( ) 
et un tableau d'objets contenant deux valeurs entieres 
encapsulees en second parametre. La valeur de retour de 
la methode invoke ( ) correspond a la valeur retournee par 
la methode invoquee — soit ici, la valeur de retour de 
calcBatAvg ( ) . Si la methode retourne un primitif, la 
valeur est d'abord encapsulee dans un objet et retournee 
sous forme d'objet. Si la methode possede le type de 
retour void, la valeur null est retournee. La methode 
calcBatAvg () retourne une valeur Float. Nous transty- 
pons done l'objet retourne afm d'en faire un objet Float. 
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Cette technique pourrait etre utile pour Fimplementation 
d'un debogueur permettant a l'utilisateur de selectionner 
une methode et de Pinvoquer. La methode selectiomiee 
ne pouvant etre connue avant l'execution, elle peut etre 
retrouvee de maniere reflexive puis invoquee au moyen 
de cette technique. 

Charger et instancier une classe 
de maniere dynamique 



Class personClass = Class. forName(personClassName) ; 
Object personObject = personClass. newlnstance(); 
Person person = (Person)personObject; 



Les methodes Class. forName( ) et newlnstance ( ) de l'objet 
Class permettent de charger et d'instancier dynaniique- 
ment une classe dont vous ne connaissez pas le nom 
jusqu'a l'execution. Dans cet exemple, nous chargeons 
notre classe en utilisant la methode Class . forName( ) a 
laquelle nous passons le nom de la classe a charger, for- 
Name() retourne un objet Class. 

Nous appelons ensuite la methode newlnstance ( ) sur 
l'objet Class pour instancier une instance de la classe. La 
methode newlnstance( ) retourne un type Object general 
que nous transtypons dans le type attendu. 

Cette technique peut etre particulierement utile si vous 
avez une classe qui etend une classe de base ou imple- 
mente une interface et que vous souhaitez stocker le nom 
de la classe d'extension ou d'implementation dans un 
fichier de configuration. L'utilisateur final peut alors ajou- 
ter de maniere dynamique differentes implementations 
sans devoir recompiler l'application. Par exemple, si notre 
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application incluait le code d'exemple precedent et dans 
im plug-in, le code suivant, nous pourrions Famener 
a instancier dynamiquement un objet BusinessPerson a 
l'execution en specifiant le nom de classe complet de 
l'objet BusinessPerson dans un fichier de configuration. 
Avant d'executer notre exemple, nous lirions le nom de 
classe depuis le fichier de configuration et attribuerions 
cette valeur a la variable personClassName. 
public class BusinessPerson extends Person { 

//Corps de la classe, etends le comportement 
■»de la classe Person 

} 

Le code de l'application n'inclurait ainsi aucune reference 
a la classe BusinessPerson elle-meme. II ne serait done 
necessaire de coder en dur que la classe de base ou l'inter- 
face generique, l'implementation specifique pouvant etre 
configuree de maniere dynamique a l'execution en edi- 
tant le fichier de configuration. 



17 



Empaquetage 
et documentation 
des classes 



Les applications Java sont generalement constitutes de 
nombreuses classes et peuvent parfois meme en compter 
des centames ou des milliers. 

Puisque le Java requiert que chaque classe publique soit 
definie dans un fichier separe, vous aurez au moins autant 
de fichiers que vous avez de classes. Ce foisonnement 
peut rapidement devenir ingerable lorsqu'il s'agit de tra- 
vailler avec des classes, de retrouver des fichiers ou d'ins- 
taller et de distribuer une application. Ce probleme a 
heureusement ete anticipe des la creation du Java. Sun a 
defini un mecanisme d'enipaquetage standard permettant 
de placer les classes liees dans des paquetages. Les paque- 
tages utilises en Java permettent d'organiser les classes 
d'apres leurs fonctionnalites. Le mecanisme d'enipaque- 
tage organise egalement les fichiers source Java en une 
structure de repertoires connue definie par rapport aux 
noms des paquetages utilises. 
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Un mecanisme standard en Java est aussi propose pour 
empaqueter les classes Java en fichiers d'archive standard. 
Les applications peuvent etre executees directement 
depuis le fichier d'archive et des bibliotheques distributes 
sous forme d'archive. Le fichier d'archive Java standard est 
le fichier JAR, qui possede l'extension .jar. II utilise le 
protocole d'archivage ZIP. Les fichiers JAR peuvent etre 
extraits en utilisant n'importe quel outil prenant en charge 
la decompression des archives ZIP. Sun propose ega- 
lement 1' outil jar pour creer et decompresser des archives 
JAR. Celui-ci fait partie de la distribution JDK standard. 
JAR est l'acronyme de Java Archive. 



Creer un paquetage 



package com. timothyfisher. book 



Dans les applications ou les bibliotheques de grande taille, 
les classes Java s'organisent generalement sous forme de 
paquetages. Pour placer une classe dans un paquetage, il 
vous suffit d'inclure une instruction package au debut du 
fichier de classe, comme le montre Fexemple precedent. 
L'instruction package doit correspondre a la premiere ligne 
non commentee du fichier de classe. Dans notre exemple, 
nous attribuons la classe contenue dans le fichier ou l'ins- 
truction figure au paquetage com. timothyfisher. book. 

Le nom du paquetage de la classe fait partie de son nom 
complet. Si nous creons une classe nominee MathBook 
dans le paquetage com. timothyfisher . book, le nom com- 
plet de la classe est alors com. timothyfisher . book .Math- 
Book. Les noms de paquetage regissent egalement la 
structure des repertoires dans lesquels les fichiers source 
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des classes sont stockes. Chaque element du nom de che- 
min represente un repertoire. Par exemple, si votre reper- 
toire racine du code source est project/src, le code 
source pour la classe MathBook est stocke dans le repertoire 
suivant : 

pro ject/src /com/ timothyf isher/ book/ 

Les bibliotheques Java standard sont toutes organisees dans 
des paquetages avec lesquels vous devez etre familiarise. 
Parmi les exemples de paquetages, on peut citer java.io, 
java.lang ou bien encore java.util. 

Les classes stockees dans un paquetage peuvent aussi etre 
importees facilement dans un fichier. Vous pouvez ainsi 
importer un paquetage entier dans votre fichier source 
Java avec la syntaxe suivante : 

import java.util.*; 

Cette instruction import importe toutes les classes conte- 
nues dans le paquetage java.util. Notez cependant 
qu'elle n'importe pas les classes contenues dans les sous- 
paquetages de java.util, comme celles contenues dans 
le paquetage java.util. logging. Une instruction import 
separee est requise pour l'importation de ces classes. 

Le Java 5.0 a introduit une nouvelle fonctionnalite liee a 
l'importation des classes appelee importations statiques. Les 
importations statiques permettent d'importer des mem- 
bres statiques de classes en leur permettant d'etre utilises 
sans qualification de classe. Par exemple, pour referencer 
la mefhode cos ( ) dans le paquetage j ava . lang . Math, vous 
pourrez vous y referer de la maniere suivante : 

double val = Math.cos(90) ; 
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Pour cela, vous devrez importer le paquetage java.lang 
.Math a l'aide d'une importation statique, comme ceci : 

import static java . lang .Math .* ; 

Vous pouvez faire reference a la methode cos() de la 
maniere suivante : 
double val = cos(90) ; 

Lors de l'execution d'une application Java depuis la ligne 
de commande avec l'executable java, vous devez inclure 
le nom de paquetage complet lorsque vous specifiez la 
classe executable principale. Par exemple, pour executer 
une methode main ( ) dans 1' exemple MathBook signale pre- 
cedemment, vous devrez taper ceci : 

j ava com . timothyf isher . book . MathBook 

Cette commande est executee depuis la racine de la struc- 
ture du paquetage — ici, le repertoire parent du repertoire 
com. 

Les classes qui ne sont pas specifiquement attribuees a un 
paquetage avec une instruction package sont considerees 
etres incluses dans un paquetage "par defaut". Le bon usage 
exige que vous placiez toujours vos classes dans des paque- 
tages definis par vos soins. Les classes qui se trouvent dans 
le paquetage par defaut ne peuvent pas etre importees ni 
utilisees a l'interieur des classes des autres paquetages. 

Documenter des classes 
avec JavaDoc 



javadoc -d \ home \ html 
-sourcepath \home\src 
-subpackages java.net 
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JavaDoc est un outil permettant de generer de la docu- 
mentation d'API au format HTML a partir de cornrnen- 
taires places dans les fichiers de code source Java. L'outil 
JavaDoc fait partie integrante de l'installation standard 
du JDK. 

L'exemple presente ici illustre un type d'usage particulier 
de l'outil JavaDoc. JavaDoc possede de nombreuses options 
et de nombreux drapeaux en ligne de commande qui peu- 
vent etre utilises pour documenter des classes et des paque- 
tages. Pour obtenir une description complete des options 
de JavaDoc, consultez la documentation de Sun (en 
anglais) a l'adresse http://java.sun.eom/j2se/l.5.0/ 
docs/ guide/javadoc/index.html. 

La commande javadoc utilisee dans cet exemple genere 
une documentation JavaDoc pour toutes les classes conte- 
nues dans le paquetage java.net et tous ses sous-paqueta- 
ges. Le code source doit se trouver dans le repertoire 
\home\src directory. La sortie de la commande est ecrite 
dans le repertoire \ home \ html. 

Voici un exemple classique de commentaire JavaDoc dans 
un fichier source Java : 
I * * 

* Un commentaire decrivant une classe ou une methode 

* 

* Les balises speciales sont precedees par le caractere @ 

* pour documenter les parametres de methode, types de 

* retour, nom d'auteur de methode ou de classe, etc. Voici 

* un exemple de parametre documente. 

* @param input Les donnees d 1 entree pour cette methode. 
*/ 
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Les sequences de caracteres /** et */ signalent le debut et 
la fin d'un commentaire JavaDoc. 

L'outil JavaDoc produit une sortie analogue a la documen- 
tation de classe Java standard que vous aurez inevitablement 
rencontree si vous avez consulte des documents Java en 
ligne par le passe. Le JDK est lui-meme documente avec 
la documentation JavaDoc. Pour visualiser la JavaDoc du 
JDK, rendez-vous a l'adresse suivante : http:/ /java.sun 
.com/j2se/1.5.0/docs/api/index.html. 

La documentation generee par JavaDoc permet de par- 
courir facilement les classes qui composent une applica- 
tion ou une bibliotheque. Une page d'index propose une 
liste de toutes les classes et des liens hypertexte vers cha- 
cune d'entre elles. Des index sont egalement fournis pour 
chaque paquetage. 

La creation de la documentation JavaDoc s'integre sou- 
vent au processus de generation des applications. Si vous 
utilisez l'outil de compilation Ant, il existe ainsi une tache 
Ant permettant de generer la JavaDoc dans le cadre de 
votre processus de generation et de compilation. 

La technologie qui permet a JavaDoc de fonctionner a 
egalement ete utilisee il y a peu pour creer d'autres outils 
dont les fonctionnalites sortent du simple cadre de la 
documentation des fichiers Java. LAPI Doclet est ainsi 
utilisee par JavaDoc et des outils tiers. L'un de ces outils 
tiers, parmi les plus populaires, est le projet open source 
XDoclet. 

XDoclet est un moteur servant a la programmation orien- 
tee attribut. II permet d'ajouter des metadonnees a votre 
code source afin d'automatiser des taches telles que la 
creation d'EJB. Pour plus d'informations sur XDoclet, 
consultez le site http://xdoclet.sourceforge.net/. 
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L'API Taglet est une autre API utile pour le travail avec les 
commentaires de style JavaDoc qui fait partie du Java stan- 
dard. Elle permet de creer des programmes appeles Taglets 
qui peuvent modifier et formater des commentaires de style 
JavaDoc contenus dans vos fichiers source. Pour plus d'infor- 
mations sur les Taglets, rendez-vous a l'adresse http:/ /java 
.sun.com/j2se/l. 4. 2/ docs/ tooldocs/javadoc/ taglet/ 
overview.html. 

Archiver des classes avec Jar 



jar cf project. jar *. class 



L'utilitaire jar est inclus dans le JDK. II permet d'empa- 
queter des groupes de classes en un lot et de creer, mettre 
a jour, extraire, lister et indexer des fichiers JAR. Avec 
l'instruction de cet exemple, toutes les classes contenues 
dans le repertoire courant depuis lequel la commande jar 
est executee sont placees dans un fichier JAR nomme 
project, jar. 

L'option c demande a l'utilitaire jar de creer un nouveau 
fichier d'archive. L'option f est toujours suivie par un 
nom de fichier specifiant le nom du fichier JAR a utiliser. 

Des applications completes peuvent etre distribuees sous 
forme de fichiers JAR. Elles peuvent egalement etre exe- 
cutees depuis le fichier JAR sans avoir a les extraire au 
prealable. Pour plus d'informations a ce sujet, consultez 
1' exemple "Executer un programme depuis un fichier 
JAR" de ce chapitre. 

Toutes les classes contenues dans un fichier JAR peuvent 
aisement etre incluses dans le CLASSPATH lors de l'execution 
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ou de la compilation d'une application ou d'une biblio- 
theque Java. Pour inclure le contenu d'un fichier JAR 
dans le CLASSPATH, incluez le chemin coniplet au fichier 
JAR au lieu du seul repertoire. Par exeniple, l'instruction 
CLASSPATH pourrait ressembler a ceci : 

CLASSPATH=. ;c: \pro j ects\f isher . j ar ; c : \proj ects\ classes 

Cette instruction inclut toutes les classes contenues dans 
l'archive fisher, jar dans le CLASSPATH. Notez bien que 
pour inclure les classes dans un fichier JAR, vous devez 
specifier le nom du fichier JAR dans le chemin de classe. 
II ne sufiit pas de pointer vers un repertoire contenant 
plusieurs fichiers JAR comme il est possible de le faire 
avec les fichiers .class. 

Pour plus d'informations sur l'utilisation de l'outil jar, 
consultez la documentation JAR officielle sur le site de 
Sun a l'adresse http:/ /java.sun.com/j2se/1.5.0/ docs/ 
guide/jar/index. html. 

Executer un programme 
a partir d'un fichier JAR 



java -jar Scorebook. jar 



L'executable en ligne de commande java permet d'exe- 
cuter une application Java empaquetee dans un fichier 
JAR. Pour cela, vous devez utiliser le commutateur —jar 
a l'execution de la commande java. Vous devez aussi 
specifier le nom du fichier JAR contenant l'application a 
executer. 

La classe contenant la methode main( ) que vous souhaitez 
executer doit etre declaree dans un fichier de manifeste. 
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Par exemple, pour executer la classe com. timothy- 
fisher . Scorebook, vous pourriez utiliser un fichier de 
manifeste dont le contenu serait le suivant : 
Manifest-Version: 1.2 
Main -Class : com . timothyf isher . Scorebook 
Created-By: 1.4 (Sun Microsystems Inc.) 

Ce fichier de manifeste devrait alors etre place dans le 
fichier JAR avec vos classes. 

Cette fonctionnalite permet aux developpeurs Java de dis- 
tribuer une application dans un unique fichier JAR et 
d'inclure un fichier de script comme un fichier BAT 
Windows ou un script de shell UNIX qui peuvent etre 
utilises pour lancer l'application a l'aide d'une instruction 
analogue a celle presentee dans cet exemple. 
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